agentram-mcp

Model Context Protocol server for AgentRAM. Give your AI agents persistent memory in Claude Desktop, Cline, Cursor, and any other MCP-compatible client.

What you get

10 MCP tools that map 1:1 to the AgentRAM REST API.

Personal agent memory

• store_memory: Write a value under an agent_id + key. Optional ttl_days for auto-expiry.

• retrieve_memory: Read a memory back by agent_id + key. Refunds the credit on 404.

• list_memories: List everything stored for an agent, newest first.

• search_memories: Case-insensitive text search across keys and values. No embeddings needed.

• delete_memory: Permanently delete a memory.

Shared multi-agent memory

• create_namespace: Create a shared memory pool that multiple agents can read and write to. Free.

• store_shared_memory: Write to a shared namespace.

• retrieve_shared_memory: Read from a shared namespace.

• list_shared_memories: List everything in a namespace.

Utility

• check_credits: Show your current account balance. Free, no credit deducted.

Each non-free tool costs 1 credit. Reads and writes are the same price.

Related MCP server: agentbay-mcp

Get an API key

Sign up at agentram.dev. You get 100 free credits on signup. No credit card required.

Install in Claude Desktop

Edit claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add:

{
  "mcpServers": {
    "agentram": {
      "command": "npx",
      "args": ["-y", "agentram-mcp"],
      "env": {
        "AGENTRAM_API_KEY": "agentram_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. The 10 tools will appear in the MCP picker.

Install in Cline (VS Code)

In Cline's MCP settings, add:

{
  "mcpServers": {
    "agentram": {
      "command": "npx",
      "args": ["-y", "agentram-mcp"],
      "env": {
        "AGENTRAM_API_KEY": "agentram_your_key_here"
      }
    }
  }
}

Install in Cursor

In Cursor's MCP settings, add:

{
  "mcpServers": {
    "agentram": {
      "command": "npx",
      "args": ["-y", "agentram-mcp"],
      "env": {
        "AGENTRAM_API_KEY": "agentram_your_key_here"
      }
    }
  }
}

Try it locally before publishing

npm install
npm run build
AGENTRAM_API_KEY=your_key node dist/index.js

Or open the MCP Inspector web UI:

AGENTRAM_API_KEY=your_key npx @modelcontextprotocol/inspector node dist/index.js

The Inspector lets you list tools and invoke each one manually to verify everything works against the real API.

Environment variables

Links

• AgentRAM website: agentram.dev

• Full API docs: agentram.dev/docs.html

• Issues: github.com/seanmarkwei/agentram-mcp/issues

License

MIT