Metadata-Version: 2.4
Name: logicmem-mcp
Version: 2.0.0
Summary: Connect any AI agent (Claude Code, Claude Desktop, Cursor, etc.) to LogicMem's MCP server in one command. The package ships a stdio-to-HTTP bridge that adapts the hosted MCP to your client's protocol version, and a CLI that auto-configures Claude Code/Desktop settings.json on Mac, Linux, and Windows.
Author-email: LogicFrame LLC <ed@logicframe.io>
License: MIT
Project-URL: Homepage, https://logicmem.io
Project-URL: Repository, https://github.com/LogicFrame-AI/logicmem-mcp
Project-URL: Issues, https://github.com/LogicFrame-AI/logicmem-mcp/issues
Keywords: mcp,model-context-protocol,ai,memory,claude,claude-code,logicmem,logicframe,openclaw,agent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Requires-Dist: urllib3>=1.26.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-mock; extra == "dev"

# logicmem-mcp

One-command install for the **LogicMem MCP server**. Connects Claude Code, Claude Desktop, or Cursor to the LogicMem model-context-protocol server without writing any Python files, copying any scripts, or fighting Windows path escaping.

```
pip install logicmem-mcp
logicmem-mcp install --key lm_xxxxxxxx
```

That's it. Restart Claude Code and the 108 MCP tools are live.

## What this package does

- **`logicmem-mcp install`** — auto-detects Claude Code, Claude Desktop, or Cursor on Mac / Linux / Windows, backs up its config, and writes the MCP server entry. No PowerShell, no path-escape debugging, no Python interpreter dance. The API key is requested via `Read-Host -AsSecureString` on Windows (no shell-history leak) and stored in the JSON config that Claude Code already reads.
- **`logicmem-mcp uninstall`** — symmetric removal.
- **`logicmem-mcp list`** — show every detected agent config and what's in it.
- **`logicmem-mcp serve`** — run the stdio bridge directly. (You don't need this if you use `install`; it's there for advanced users who want to hand-roll the mcp config.)

## Why a stdio bridge?

Claude Code 2.1.187 on Windows requires the MCP server to speak protocol version `2025-03-26` and respond in SSE-streaming format. The hosted LogicMem MCP at `mcp.logicmem.io/mcp` still speaks the older `2024-11-05` JSON dialect. The bridge in this package (`logicmem_mcp/bridge.py`) wraps the hosted MCP, advertises the newer protocol version, and proxies every call over HTTP. No patching the server; no writing your own bridge script.

## Install on each platform

### Windows (Claude Code in PowerShell)

```powershell
pip install logicmem-mcp
logicmem-mcp install --key lm_your_key_here
```

(Use the `pip` that ships with your Python install. If `pip` isn't on PATH, try `py -m pip install logicmem-mcp` or `python -m pip install logicmem-mcp`.)

### Mac / Linux (Claude Code or Cursor)

```bash
pip3 install logicmem-mcp
logicmem-mcp install --key lm_your_key_here
```

### CI / non-interactive

```bash
LOGICMEM_API_KEY=lm_… pip install logicmem-mcp
LOGICMEM_API_KEY=lm_… logicmem-mcp install
```

## Where do I get an API key?

Sign up at https://logicmem.io. The free tier gives you 500 memories and 1 agent. Paid plans are $29/mo (10k ops/day) and $99/mo (100k ops/day).

## What tools does the MCP server expose?

108 tools across:

- **18 memory tools** — `logicframe_memory_log`, `logicframe_memory_recall`, `logicframe_memory_stats`, `logicframe_memory_snapshot`, etc.
- **14 VAPI tools** — `vapi_create_assistant`, `vapi_list_calls`, `vapi_list_phone_numbers`, etc. (You pass your own VAPI key per call.)
- **10 Retell AI tools** — `retell_create_agent`, `retell_list_calls`, etc.
- **8 Bland.ai tools** — `bland_initiate_call`, `bland_get_transcript`, etc.
- **5 Twilio tools** — phone number and SMS management.
- **Plus** intelligence, audit, federation, conversation-resume, and constraint tools.

Each customer brings their own LLM and platform keys; the MCP just provides persistent memory and a unified tool surface.

## Verify

```bash
# Claude Code CLI
claude mcp list
# should show: logicframe-mcp  https://mcp.logicmem.io/mcp  ✓ connected
```

If it shows "Failed to connect", check:

1. Your API key is valid: `curl -X POST https://mcp.logicmem.io/mcp -H "Content-Type: application/json" -H "Authorization: Bearer $KEY" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'`
2. No firewall blocking outbound to `mcp.logicmem.io:443`
3. Reinstall the bridge: `pip install --force-reinstall logicmem-mcp`

## License

MIT
