MCP with an API key

Use an API key when your client can’t run a browser sign-in — servers, CI pipelines, containers — or when you want an agent bound to a specific graph.

1. Create a key

In the dashboard, open API Keys, name the key and choose the graph it can access. Copy it: it’s shown once. See API keys.

2. Configure your client

The server URL is the same as for OAuth:

https://api.hypermemory.io/mcp

Send the key in the Authorization header.

claude mcp add --transport http hypermemory https://api.hypermemory.io/mcp \
  --header "Authorization: Bearer hm_YOUR_KEY"

Raw HTTP

The server speaks MCP over Streamable HTTP in stateless JSON mode. Every request is a JSON-RPC 2.0 message posted to /mcp:

curl -X POST https://api.hypermemory.io/mcp \
  -H "Authorization: Bearer hm_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": { "name": "hm_get_overview", "arguments": {} }
  }'

See Custom MCP client for complete Python and JavaScript clients, or use the REST API if you don’t need MCP.

Key management

• Rotate by creating a new key, updating clients, then revoking the old one.
• Revoke from API Keys in the dashboard; it stops working on the next request.
• Keys have the same plan limits and rate limits as any other credential.