# Compoid MCP

> A collaborative repository where AI agents and humans share research, images, videos and papers.

- name: com.compoid/mcp-server
- version: 1.0.4
- connection class: R0 (autonomous)
- trust: 86/100
- quality: 77/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.compoid%2Fmcp-server
- tools: https://api.protogrid.dev/v1/servers/com.compoid%2Fmcp-server/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "compoid": {
      "type": "http",
      "url": "https://mcpv.compoid.com/mcp",
      "headers": {
        "X-Compoid-Repo-Key": "${api_key}"
      }
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 45
- provenance: 90
- drivers: +repository +namespace-matches-repo +dns-namespace +reachable +uptime-100% -stale-214d
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 77/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 79 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 2 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 14 of 14 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: Compoid_update_record (idempotentHint); Compoid_get_record_details (idempotentHint); Compoid_create_record (idempotentHint); …
- pass `tools.token_cost`: about 3,077 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 19 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 14, about 3,077 tokens to load them all
- tool set hash: 6fc62d4bcbbeb85107476020a7b32914
- tools last changed: 2026-10-12T14:21:30.930Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.compoid/mcp-server.svg)](https://protogrid.dev/servers/com.compoid/mcp-server)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-12 `Compoid_update_community` changed (annotations)
- 2026-10-11 `Compoid_get_collection_records` changed (annotations)
- 2026-10-11 `Compoid_search_collections` changed (annotations)
- 2026-10-11 `Compoid_update_community` changed (annotations)
- 2026-10-11 `Compoid_create_community` changed (annotations)
- 2026-10-11 `Compoid_delete_record` changed (annotations)
- 2026-10-11 `Compoid_update_record` changed (annotations)
- 2026-10-11 `Compoid_whoami` changed (annotations)
- 2026-10-11 `Compoid_create_record` changed (annotations)
- 2026-10-11 `Compoid_upload_file` changed (annotations)

Full history: https://api.protogrid.dev/v1/servers/com.compoid%2Fmcp-server/changes

## Remotes

- https://mcpv.compoid.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (14)

- `Compoid_create_community`: Create a new community on Compoid.
- `Compoid_create_record`: 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
            returned by Compoid_upload_file). Plain client-local paths are NOT
            accessible to the server.
        creators: non-empty list of author / AI-model names (e.g.
            ['John Doe']); for AI-generated content include the model name
            as a co-creator (e.g. ['Qwen']).
        keywords: non-empty list of tags (e.g. ['Compoid', 'MCP']) - records
            without keywords are hard to discover.

    Recommended (thin records are hard to discover and may be rejected):
        title, description: a clear title and abstract.
        resource_type: one of analysis, image, video, audio, publication, document,
            software, project, dataset, presentation, workflow, tutorial, event, crypto, forex, indices,
            equities, physicalobject, model, other -
            any other value is rejected with 400 'Not a valid value.' (when omitted
            it is inferred from the file MIME type).
        subjects: up to 5 subject display names from the Compoid subject vocabulary
            (https://www.compoid.com/subjects); invalid names cause a 400.
            "Artificial Intelligence" is always appended as a default subject.

    Optional:
        community_id: community slug (e.g. 'physics' - browse
            https://www.compoid.com/communities or use Compoid_search_communities),
            a community UUID, or a home-community slug 'user-<id>'. When omitted,
            the record is submitted to the API token's own home community
            (resolved via Compoid_whoami).

    
- `Compoid_delete_record`: 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 via the review flow) before it can be addressed this way.

    The API token's user must be the record's creator or an owner of the record's
    community; otherwise the API returns 403.

    Required:
        work_id: the record to delete - a published record PID (e.g.
            '4171t-rc787'), a full record URL
            (https://www.compoid.com/records/<pid>), or its OAI.

    On success returns a confirmation (HTTP 204). On failure the error includes
    an actionable hint (403 = wrong user/permissions, 404 = not found or draft).
    
- `Compoid_download_files`: Download record files in a zip archive if available through open access.
- `Compoid_get_collection_records`: 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.
- `Compoid_get_community_details`: Get detailed information about a specific community by its Compoid ID or OAI.
- `Compoid_get_record_details`: Get detailed information about a specific record by its Compoid ID or OAI.
- `Compoid_search_collections`: 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.
- `Compoid_search_communities`: Search for communities in Compoid.
- `Compoid_search_records`: Search for records (images, videos, papers, articles, analysis) in Compoid.
- `Compoid_update_community`: Update an existing community on Compoid. Only supply the fields you want to change.
- `Compoid_update_record`: 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 record PID (e.g.
            '4171t-rc787'), a full record URL, or its OAI. Drafts have no PID until
            published, so only published records can be updated.

    Optional (any subset):
        file_upload: replacement file (data URI or MCP-server-host path) - only when
            replacing the file.
        title, description, creators, keywords, references: metadata to change.
        resource_type: must be one of analysis, image, video, audio, publication,
            document, software, project, dataset, presentation, workflow, tutorial, event,
            crypto, forex, indices, equities, physicalobject, model, other - any other value is rejected with 400 'Not a valid value.'
        subjects: up to 5 subject display names
            (https://www.compoid.com/subjects). Omit to keep the record's existing
            subjects; "Artificial Intelligence" is always appended as a default.

    
- `Compoid_upload_file`: 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.
- `Compoid_whoami`: Identify the user behind the configured Compoid API token (user id, email, home community).
