Metadata-Version: 2.4
Name: agentrecall-mcp
Version: 1.0.0
Summary: MCP server for AgentRecall — persistent memory for AI agents
Author-email: Marco Balbona <marco.balbona@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://agentrecall.cloud
Project-URL: Documentation, https://docs.agentrecall.cloud
Project-URL: Repository, https://github.com/MarsHeer/agentrecall
Project-URL: Issues, https://github.com/MarsHeer/agentrecall/issues
Keywords: mcp,agent,memory,ai,agentrecall,semantic-search,graph-database
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0
Requires-Dist: httpx>=0.25.0

# AgentRecall MCP Server

MCP server that gives your AI agents persistent memory. Works with Claude Code, Hermes Agent, OpenClaw, and any MCP-compatible client.

## Quick Start

```bash
# Install
pip install agentrecall-mcp

# Run (cloud mode)
AGENTRECALL_API_KEY=ark_your_key agentrecall-mcp
```

## Setup by Client

### Claude Code

```bash
claude mcp add --transport stdio --scope user \
  --env AGENTRECALL_API_KEY=ark_YOUR_KEY_HERE \
  --env AGENTRECALL_AGENT_ID=claude-code \
  agentrecall -- agentrecall-mcp
```

### OpenClaw

```bash
openclaw mcp set agentrecall '{"command":"agentrecall-mcp","env":{"AGENTRECALL_API_KEY":"ark_YOUR_KEY_HERE","AGENTRECALL_AGENT_ID":"openclaw"}}'
```

### Hermes Agent

Add to `~/.hermes/config.yaml`:

```yaml
mcp_servers:
  agentrecall:
    command: "agentrecall-mcp"
    env:
      AGENTRECALL_API_KEY: "ark_YOUR_KEY_HERE"
      AGENTRECALL_AGENT_ID: "hermes-agent"
```

Then restart: `hermes gateway restart`

### Any MCP Client

The server uses stdio transport. Point your MCP client to:

```bash
AGENTRECALL_API_KEY=ark_YOUR_KEY agentrecall-mcp
```

## Configuration

| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| `AGENTRECALL_API_KEY` | — | Your AgentRecall API key (required) |
| `AGENTRECALL_API_URL` | `https://api.agentrecall.cloud/v1` | API endpoint |
| `AGENTRECALL_AGENT_ID` | `default` | Default agent identifier |

## Available Tools

| Tool | Description |
|------|-------------|
| `store_memory` | Store a memory (auto-classified by AI) |
| `search_memories` | Semantic search across memories |
| `get_memory` | Get a memory by ID |
| `update_memory` | Update memory content |
| `delete_memory` | Delete a memory |
| `list_memories` | List memories for an agent |
| `count_memories` | Count memories |
| `traverse_graph` | Traverse the knowledge graph |
| `get_graph_stats` | Get graph statistics |
| `find_graph_path` | Find path between two entities |
| `get_graph_context` | Get graph context for a query |
| `list_agents` | List all agents |
| `create_agent` | Create a new agent |

## License

MIT
