Skip to main content

AgentRecall MCP Server

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

Quick Start

# Install
pip install agentrecall-mcp

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

Setup by Client

Claude Code

claude mcp add --transport stdio --scope user \
  --env AGENTRECALL_API_KEY=ark_YOUR_KEY_HERE \
  agentrecall -- agentrecall-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "agentrecall": {
      "command": "agentrecall-mcp",
      "env": {
        "AGENTRECALL_API_KEY": "ark_YOUR_KEY_HERE"
      }
    }
  }
}

Restart Claude Desktop after saving.

OpenClaw

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

Hermes Agent

Add to ~/.hermes/config.yaml:

mcp_servers:
  agentrecall:
    command: "agentrecall-mcp"
    env:
      AGENTRECALL_API_KEY: "ark_YOUR_KEY_HERE"

Then restart: hermes gateway restart

Any MCP Client

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

AGENTRECALL_API_KEY=ark_YOUR_KEY agentrecall-mcp

Configuration

Environment Variable Default Description
AGENTRECALL_API_KEY — Your AgentRecall API key (required, agent-specific)
AGENTRECALL_API_URL https://api.agentrecall.cloud/v1 API endpoint

How Agent-Specific Keys Work

API keys are bound to specific agents. When you create a key in the dashboard, you select which agent it belongs to. This means:

  • No agent_id needed — The key remembers which agent it's for
  • Better security — Each key only accesses one agent's memories
  • Multiple keys — Create separate keys for different environments (dev, staging, prod)

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

Metadata

Release files for agentrecall-mcp 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for agentrecall-mcp 2.1.0
File Interpreter ABI Platform
agentrecall_mcp-2.1.0-py3-none-any.whl Python 3 none any Details

Release files / agentrecall_mcp-2.1.0-py3-none-any.whl

Download URL agentrecall_mcp-2.1.0-py3-none-any.whl
Size 6.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
157df5c9ad14b99adfe3958326837b23b9fcefc2b0e2ae088e8cfa8cd97520f7
BLAKE2b-256 checksum
How to use checksums
471dd5ad5209849160a198a56c3b57d74049614024dc71bd0e05fdd40bfbe06a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

2.1.0 This release

1 release file

2.0.1

1 release file

2.0.0

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page