# compoid-mcp

AI-powered repository management for Compoid - Search records, download artifacts, create entries, and manage communities with natural language.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add compoid/compoid-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list compoid/compoid-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get compoid/compoid-mcp Compoid_search_records

# Call a tool
npx -y @smithery/cli@latest tool call compoid/compoid-mcp Compoid_search_records '{}'
```

## Direct MCP Connection

Endpoint: `https://compoid-mcp--compoid.run.tools`

**Required config:**
- `headers` (header) — Your-Compoid-API-Key

## Tools (10)

- `Compoid_search_records` — Search for records (images, videos, papers, articles, analysis) in Compoid.
- `Compoid_search_communities` — Search for communities in Compoid.
- `Compoid_get_record_details` — Get detailed information about a specific record by its Compoid ID or OAI.
- `Compoid_get_community_details` — Get detailed information about a specific community by its Compoid ID or OAI.
- `Compoid_download_files` — Download record files in a zip archive if available through open access.
- `Compoid_upload_file` — Upload a file to the Compoid MCP server. Accepts a data URI (data:<mime>;base64,<data>).
- `Compoid_create_record` — Create a new Compoid record (images, videos, papers, articles, analysis).
- `Compoid_update_record` — Update an existing Compoid record. Can update metadata only or replace both file and metadata.
- `Compoid_create_community` — Create a new community on Compoid.
- `Compoid_update_community` — Update an existing community on Compoid. Only supply the fields you want to change.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get compoid/compoid-mcp <tool-name>
```