Compoid MCP — Claude Code MCP server: durable agent memory
Gives an agent a workspace shared with people: it looks up project context there and writes results back. Useful when work spans many sessions.
claude mcp add --transport http mcp-server https://mcpv.compoid.com/mcpWhat Compoid MCP does
Compoid MCP is a remote server at https://mcpv.compoid.com/mcp. An agent can search records and communities, narrowing by title, description, keywords, dates, resource type or access level, read the metadata, create and update records, pull open-access items as a zip and push files through a data URI. Communities are editable too: create them, adjust curation and access policies, walk their collection trees.
Memory here is structured rather than a chat log. A record carries a title, description, keywords, up to five subjects, a resource type and provenance; edits mint new versions while the earlier history stays. Two shapes fit most work: one community per project, where the agent drops decisions and plans, or the default community as standing personal memory for preferences and notes.
You need a Compoid account and a repository key, sent in the X-Compoid-Repo-Key header. Without it the server will not answer. A local route exists as well: the compoid-mcp package installs from PyPI, and the config then carries variables such as COMPOID_REPO_API_KEY and DOWNLOAD_PATH.
What it helps with
- restore project context in a fresh agent session
- hand work over from one agent to another
- locate a record by type, date or creator
- download open-access material as an archive
- keep sensitive notes out of the public index
Example prompts for the agent
- Search my community for records about the auth scheme and summarise what was decided
- Write the caching decision into the project community and add keywords
- Create a community for the new project and add the first note
How to install Compoid MCP
Platform CLI: remote server
claude mcp add --transport http mcp-server https://mcpv.compoid.com/mcpPlatform CLI: remote server
codex mcp add compoid-mcp --url https://mcpv.compoid.com/mcpConfig file
{
"mcpServers": {
"compoid-mcp": {
"url": "https://mcpv.compoid.com/mcp"
}
}
}Config file
{
"servers": {
"compoid-mcp": {
"type": "http",
"url": "https://mcpv.compoid.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http compoid-mcp https://mcpv.compoid.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Compoid MCP
How do I install Compoid MCP in Claude Code?
Run claude mcp add --transport http compoid-mcp https://mcpv.compoid.com/mcp. Pass your repository key in the X-Compoid-Repo-Key header.
What does Compoid MCP do?
It connects an agent to a Compoid workspace: searching and reading records, creating and updating them, handling files and communities. That gives memory which outlives a session.
What is required to run it?
A Compoid account and a repository key. Each account comes with a personal token named compoid-<user id>, and more tokens can be created from the account.
