MCP Integration

What is MCP?

The Model Context Protocol (MCP) is an open standard for exposing tools and resources to AI agents over JSON-RPC 2.0. Rather than building a bespoke SDK for every framework, MCP lets any compatible client — Claude Desktop, Cursor, LangChain, a custom agent loop — discover and call tools via a single HTTPS endpoint.

Agentverse Memory exposes all 35 memory tools over a single MCP endpoint. No SDK required — the MCP endpoint plus cURL is the working path today (first-party Python and TypeScript SDKs are coming soon).

Connection Details

Give Claude Persistent Memory in 5 Minutes

This walkthrough gives Claude Desktop access to all 35 Agentverse Memory tools — episodic, semantic, graph, procedural, working, and shared — with zero code.

curl -X POST https://am-server-jbneh74b5q-uc.a.run.app/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"my-agent","tier":"explorer"}'
# → {"key":"am_...","key_id":"...","agent_id":"my-agent",
#    "tier":"explorer","monthly_op_limit":50000}

{
  "mcpServers": {
    "agentverse-memory": {
      "url": "https://am-server-jbneh74b5q-uc.a.run.app/mcp",
      "headers": {
        "X-API-Key": "am_your_key_here"
      }
    }
  }
}

curl https://am-server-jbneh74b5q-uc.a.run.app/health
# → {"service":"am-server","status":"ok","version":"0.1.0"}

Client Configurations

{
  "mcpServers": {
    "agentverse-memory": {
      "url": "https://am-server-jbneh74b5q-uc.a.run.app/mcp",
      "headers": {
        "Authorization": "Bearer am_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "agentverse-memory": {
      "url": "https://am-server-jbneh74b5q-uc.a.run.app/mcp",
      "headers": {
        "Authorization": "Bearer am_your_key_here"
      }
    }
  }
}

{
  "agentverse-memory": {
    "serverUrl": "https://am-server-jbneh74b5q-uc.a.run.app/mcp",
    "headers": {
      "Authorization": "Bearer am_your_key_here"
    }
  }
}

curl -X POST https://am-server-jbneh74b5q-uc.a.run.app/mcp \
  -H "Authorization: Bearer am_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

curl -X POST https://am-server-jbneh74b5q-uc.a.run.app/mcp \
  -H "Authorization: Bearer am_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "memory_store_episode",
      "arguments": {
        "content": "Completed Q1 analysis for user_42."
      }
    }
  }'

All 35 MCP Tools

All tools are available at every plan tier unless noted. memory_traverse_graph (BFS/DFS) is available on all tiers including Explorer (free); memory_find_path (A* pathfinding) and the 5 shared-space tools require Builder+. See the API Reference for full parameter schemas.

Authentication

All requests must include an Authorization header:

Authorization: Bearer am_your_key_here

export AM_API_KEY="am_your_key_here"

API keys are scoped to your account. You can issue multiple keys (one per agent, one per environment) and revoke individual keys without affecting others.

Rate Limits

Applied per API key (not per agent_id).

"Ops" are counted per MCP tool call. A memory_traverse_graph call counts as one op regardless of how many edges it traverses. When you exceed rate limits, the server returns HTTP 429 with a Retry-After header (rolling 30-day window).

Error Codes

{
  "jsonrpc": "2.0",
  "id": 3,
  "error": {
    "code": -32029,
    "message": "Rate limit exceeded",
    "data": {
      "limit": 50000,
      "used": 50001,
      "reset_at": "2026-07-01T00:00:00Z",
      "retry_after": 1814400
    }
  }
}