seanmarkwei/agentram-mcp

MCP server for AgentRAM. It gives your AI agents persistent memory through a set of tools, with no vector database and no embedding pipeline to set up. Get a key, paste the config below, and you're running in about a minute.
Works with any MCP client: Claude Desktop, Claude Code, Cline, Cursor, Windsurf, and others.
Why
Every agent session starts with amnesia. AgentRAM is a plain HTTP memory store built for agents: one call to save something, one call to read it back. No infra to stand up, no vectors to babysit. This package wraps that API as MCP tools so your agent can just use it.
Setup
You need an API key first. Register at agentram.dev and it gets emailed to you. New accounts start with 1,000 credits and no card is required.
Then add this to your client's MCP config. For Claude Desktop that file is claude_desktop_config.json (on macOS it lives at ~/Library/Application Support/Claude/claude_desktop_config.json):
Restart the client and the tools show up. Most clients let you mark them "always allow" so you're not clicking approve on every call.
One gotcha on macOS: Claude Desktop doesn't ship with Node, so install Node 18 or newer first or the server won't start.
Tools
Fifteen tools. Ten for flat memory, five for temporal memory (facts that change over time).
Flat memory:
- store_memory: save a value under a key for an agent
- retrieve_memory: read one back by key
- list_memories: list everything stored for an agent
- search_memories: text search across keys and values, no embeddings needed
- delete_memory: remove one
- check_credits: current balance, free to call
Shared memory, for when more than one agent needs the same pool:
- create_namespace: make a shared space, free to call
- store_shared_memory: write into it
- retrieve_shared_memory: read from it
- list_shared_memories: list what's in it
Temporal memory (assertions):
- store_assertion: record a fact that can change, like a plan, a status, or a preference
- retire_assertion: mark a fact as no longer true while keeping the history
- get_assertion: what's currently true for a key
- list_assertions: all the current facts for an agent
- get_assertion_history: the full chain of what a key has been over time
About temporal memory
Flat memory overwrites. Temporal memory keeps the trail. When a fact changes you supersede the old value, and the previous values stick around so you can see how you got to the current one.
The part worth knowing: if two different values land on the same key and neither one supersedes the other, get_assertion will not quietly pick a winner. It tells you the key is contested and returns both values, so your agent can decide instead of running on a guess. list_assertions flags which keys are in that state.