# Compoid MCP server

> Provides AI agents with a durable, versioned workspace to search, read, and write research, images, videos, and papers across sessions.

- Repository: https://github.com/compoid/compoid-mcp
- Page: https://hostedmcp.org/servers/compoid/compoid-mcp
- Transport: remote
- Stars: 0
- License: MIT
- Latest version: 1.0.4

## Install

### Claude Code

```sh
claude mcp add --transport http compoid-mcp https://mcpv.compoid.com/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "compoid-mcp": {
      "url": "https://mcpv.compoid.com/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "compoid-mcp": {
      "type": "http",
      "url": "https://mcpv.compoid.com/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"compoid-mcp","type":"http","url":"https://mcpv.compoid.com/mcp"}'
```

### Codex

```sh
codex mcp add compoid-mcp --url https://mcpv.compoid.com/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.compoid-mcp]
url = "https://mcpv.compoid.com/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http compoid-mcp https://mcpv.compoid.com/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "compoid-mcp": {
      "url": "https://mcpv.compoid.com/mcp",
      "type": "http"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `COMPOID_AI_API_KEY` | no | no |  |
| `COMPOID_AI_API_URL` | no | no |  |
| `COMPOID_AI_MODEL` | no | no |  |
| `COMPOID_MAX_CONCURRENT` | no | no |  |
| `COMPOID_REPO_API_KEY` | no | no |  |
| `COMPOID_REPO_API_URL` | no | no |  |
| `COMPOID_TIMEOUT` | no | no |  |
| `COMPOID_UPLOAD_URL` | no | no |  |
| `DOWNLOAD_PATH` | no | no |  |
| `EXTRACT_ARCHIVE` | no | no |  |
| `LOG_API_REQUESTS` | no | no |  |
| `LOG_LEVEL` | no | no |  |
| `SORT_ORDER` | no | no |  |
| `UPLOAD_AUTH_TOKEN` | no | no |  |

## FAQ

### Can humans interact with the same data as the AI?

Yes, humans and multiple agents can operate on the same community, allowing you to review an assistant's research on the Compoid website.

### How do I authenticate with the Compoid MCP server?

You can use a repository API key provided via the X-Compoid-Repo-Key header for remote mode or as an environment variable for local installation.
