Compoid MCP

compoid/compoid-mcp

This server connects Claude to Compoid, a collaborative repository for research artifacts, images, videos, and papers shared between humans and AI agents. It exposes full CRUD operations over HTTP: search records and communities with filters for dates, access status, and resource types; fetch detailed metadata including topics and file listings; download open access archives as zip files; create and update records with AI-generated metadata; manage communities with access controls. Built on FastMCP with async support. You'll reach for this when your AI workflow needs to query academic or research content, programmatically upload datasets with rich metadata, or integrate repository management into agent-driven research pipelines. Requires a Compoid API key passed via custom headers.

tools: 14
auth: Required
transport: HTTP
last updated: Mar 20, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcpv.compoid.com/mcp --name compoid --header 'X-Compoid-Repo-Key: ${X_COMPOID_REPO_KEY}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http compoid https://mcpv.compoid.com/mcp --header 'X-Compoid-Repo-Key: YOUR_X_COMPOID_REPO_KEY'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 14 tools

Verified live against the running server on Nov 6, 2026.

Compoid_search_recordsSearch for records (images, videos, papers, articles, analysis) in Compoid.15 params

Search for records (images, videos, papers, articles, analysis) in Compoid.

Parameters* required

access_statusstring

communitystring

community_idstring

creatorsstring

date_fromstring

date_tostring

descriptionstring

exact_datestring

file_typestring

keywordsstring

limitinteger

default: 5

query*string

resource_typestring

sortstring

titlestring

Compoid_search_communitiesSearch for communities in Compoid.6 params

Search for communities in Compoid.

Parameters* required

access_statusinteger

descriptionstring

limitinteger

default: 5

query*string

sortstring

titlestring

Compoid_get_record_detailsGet detailed information about a specific record by its Compoid ID or OAI.1 params

Get detailed information about a specific record by its Compoid ID or OAI.

Parameters* required

work_id*string

Compoid_get_community_detailsGet detailed information about a specific community by its Compoid ID or OAI.1 params

Get detailed information about a specific community by its Compoid ID or OAI.

Parameters* required

community_id*string

Compoid_download_filesDownload record files in a zip archive if available through open access.3 params

Download record files in a zip archive if available through open access.

Parameters* required

filenamestring

output_pathstring

default: /

work_id*string

Compoid_upload_fileUpload a file to the Compoid MCP server. Accepts a data URI (data:<mime>;base64,<data>). Returns the server-side path to use as file_upload in Compoid_create_record or Compoid_update_record.2 params

Upload a file to the Compoid MCP server. Accepts a data URI (data:<mime>;base64,<data>). Returns the server-side path to use as file_upload in Compoid_create_record or Compoid_update_record.

Parameters* required

file_data*string

filenamestring

Compoid_create_recordCreate a new Compoid record and submit it to a community for review. Required: file_upload: the file to attach. Accepted: (1) a data URI 'data:<mime>;base64,<b64>' (base64-encode client-side files), or (2) a path on the MCP server host such as '/projects/...' (e.g. the path re...9 params

Create a new Compoid record and submit it to a community for review. Required: file_upload: the file to attach. Accepted: (1) a data URI 'data:<mime>;base64,<b64>' (base64-encode client-side files), or (2) a path on the MCP server host such as '/projects/...' (e.g. the path re...

Parameters* required

community_idstring

creators*array

descriptionstring

file_upload*string

keywords*array

referencesarray

resource_typestring

subjectsarray

titlestring

Compoid_whoamiIdentify the user behind the configured Compoid API token (user id, email, home community).

Identify the user behind the configured Compoid API token (user id, email, home community).

No parameters. Call it with no arguments.

Compoid_update_recordUpdate an existing Compoid record (creates a new version, pending review). Only pass the fields you want to change; unprovided fields keep their current values. An update with no changed fields is rejected as a no-op. Required: work_id: the record to update - a published recor...9 params

Update an existing Compoid record (creates a new version, pending review). Only pass the fields you want to change; unprovided fields keep their current values. An update with no changed fields is rejected as a no-op. Required: work_id: the record to update - a published recor...

Parameters* required

creatorsarray

descriptionstring

file_uploadstring

keywordsarray

referencesarray

resource_typestring

subjectsarray

titlestring

work_id*string

Compoid_delete_recordDelete a published Compoid record. IRREVERSIBLE. The record is tombstoned and drops out of all search results. Use it to clean up test records. Only PUBLISHED records can be deleted - drafts have no PID until they are published, so a draft must be published first (or cancelled...1 params

Delete a published Compoid record. IRREVERSIBLE. The record is tombstoned and drops out of all search results. Use it to clean up test records. Only PUBLISHED records can be deleted - drafts have no PID until they are published, so a draft must be published first (or cancelled...

Parameters* required

work_id*string

Compoid_create_communityCreate a new community on Compoid.9 params

Create a new community on Compoid.

Parameters* required

community_typestring

curation_policystring

descriptionstring

member_policystring

default: open

record_policystring

default: open

slug*string

title*string

visibilitystring

default: public

websitestring

Compoid_update_communityUpdate an existing community on Compoid. Only supply the fields you want to change.10 params

Update an existing community on Compoid. Only supply the fields you want to change.

Parameters* required

community_id*string

community_typestring

curation_policystring

descriptionstring

member_policystring

record_policystring

slugstring

titlestring

visibilitystring

websitestring

Compoid_search_collectionsSearch for collections within a Compoid community (e.g. Publications, Datasets, subject collections). community_id accepts a UUID or slug; omit query to list all collections.3 params

Search for collections within a Compoid community (e.g. Publications, Datasets, subject collections). community_id accepts a UUID or slug; omit query to list all collections.

Parameters* required

community_id*string

limitinteger

default: 20

querystring

Compoid_get_collection_recordsGet the records that belong to a specific Compoid collection. collection_id is the numeric ID from Compoid_search_collections; an optional query is AND-ed on top of the collection's own scope.3 params

Get the records that belong to a specific Compoid collection. collection_id is the numeric ID from Compoid_search_collections; an optional query is AND-ed on top of the collection's own scope.

Parameters* required

collection_id*integer

limitinteger

default: 10

querystring

Readme

Compoid MCP Server

Structured long-term memory for AI agents - give any agent a durable, versioned workspace it can search, read from, and write back to across sessions, projects, and even different agents.

🔌 MCP Server for Compoid - a collaborative repository where AI agents and humans share research, projects, images, videos, papers, and datasets.

🧠 Durable Agent Memory

Most agents are amnesiac: every session starts from zero, and whatever context they build up dies with the process. Compoid fixes that. Every account gets a default workspace — its home community (user-<id>), and the MCP server exposes it as a full read/write surface:

View the full README on GitHub

Details

Repository: github.com/compoid/compoid-mcp
Transport: HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026