{
  "markdown": "# agentram-mcp\n\nMCP server for [AgentRAM](https://agentram.dev). 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.\n\nWorks with any MCP client: Claude Desktop, Claude Code, Cline, Cursor, Windsurf, and others.\n\n## Why\n\nEvery 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.\n\n## Setup\n\nYou need an API key first. Register at [agentram.dev](https://agentram.dev) and it gets emailed to you. New accounts start with 1,000 credits and no card is required.\n\nThen 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`):\n\n```json\n{\n  \"mcpServers\": {\n    \"agentram\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"agentram-mcp\"],\n      \"env\": {\n        \"AGENTRAM_API_KEY\": \"agentram_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart the client and the tools show up. Most clients let you mark them \"always allow\" so you're not clicking approve on every call.\n\nOne gotcha on macOS: Claude Desktop doesn't ship with Node, so install Node 18 or newer first or the server won't start.\n\n## Tools\n\nFifteen tools. Ten for flat memory, five for temporal memory (facts that change over time).\n\nFlat memory:\n\n- `store_memory`: save a value under a key for an agent\n- `retrieve_memory`: read one back by key\n- `list_memories`: list everything stored for an agent\n- `search_memories`: text search across keys and values, no embeddings needed\n- `delete_memory`: remove one\n- `check_credits`: current balance, free to call\n\nShared memory, for when more than one agent needs the same pool:\n\n- `create_namespace`: make a shared space, free to call\n- `store_shared_memory`: write into it\n- `retrieve_shared_memory`: read from it\n- `list_shared_memories`: list what's in it\n\nTemporal memory (assertions):\n\n- `store_assertion`: record a fact that can change, like a plan, a status, or a preference\n- `retire_assertion`: mark a fact as no longer true while keeping the history\n- `get_assertion`: what's currently true for a key\n- `list_assertions`: all the current facts for an agent\n- `get_assertion_history`: the full chain of what a key has been over time\n\n## About temporal memory\n\nFlat 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.\n\nThe 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.\n\nFlat and temporal are separate keyspaces. A key called `plan` in `store_memory` and a key called `plan` in `store_assertion` have nothing to do with each other. Use flat memory for stuff you just overwrite, and assertions for facts you want a record of.\n\n## Credits\n\nReads and writes cost 1 credit each. `check_credits` and `create_namespace` are free. A read that finds nothing (a 404) refunds the credit. Most responses include your `credits_remaining` so you can watch the balance.\n\n## Config\n\n- `AGENTRAM_API_KEY` (required): your key, starts with `agentram_`\n- `AGENTRAM_API_BASE` (optional): defaults to `https://api.agentram.dev`\n\n## Links\n\n- Site: https://agentram.dev\n- Docs: https://agentram.dev/docs.html\n- Issues: https://github.com/seanmarkwei/agentram-mcp/issues\n\nMIT",
  "bytes": 3849,
  "sha": "fc86d1af3d22614de18a7148f8cc7576a1b363b62435618eede3f143aff6e242",
  "repo_slug": "seanmarkwei/agentram-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_seanmarkwei_agentram_mcp_57c8f392/readme"
}