MCP for OCP GraphQL API

An MCP server for the Open Collective GraphQL API v2. It gives an AI assistant three tools to learn the schema, search the docs, and run read-only queries against Open Collective — without exposing any write operations.

Contents

• Using with AI safely
• Prerequisites (one time)
  • Claude Code and VS Code
  • uv
• Install — Claude Code plugin (easiest)
  • Authorize for one session
  • Authorize permanently
• Two ways to run
  • Local — stdio (recommended)
  • Hosted — Streamable HTTP + OAuth
• The three tools
• Further reading
• Stack & credits

Using with AI safely

Open Collective data includes personally identifiable information (names, emails, payout details, addresses). This server is a generic read-only GraphQL proxy — the graphql_query tool can select any field the underlying token is allowed to read, so the guardrail against leaking PII is prompt-level, not enforced in code.

• Prefer running locally (the stdio transport below) so your data and token never leave your machine.
• Prefer anonymous mode (no token) when you only need public data — you then only ever see what the public API exposes.
• For exports that should stay off the model entirely (PII pulls, CSV/Markdown/PDF reports), use the ready-made local scripts indexed in reporting/README.md — you run them yourself and the results land in the gitignored reporting/output/ folder, never in an AI context.

Tokens are never logged or persisted by this server. For the full PII posture and safe field-selection guidance, see docs/using-with-ai-safely.md.

Prerequisites (one time)

Before installing the plugin you need Claude Code itself, plus a small tool called uv. Both are one-time installs.

Claude Code and VS Code

The plugin runs inside Claude Code, which needs a paid Claude plan (Pro, Max, Team, or Enterprise — the free plan doesn't include it).

The friendliest setup is Claude Code inside VS Code, a free code editor:

1. Install VS Code (version 1.98 or newer).
2. In VS Code, open the Extensions panel (Cmd/Ctrl+Shift+X), search for Claude Code (published by Anthropic), and click Install.
3. Click the Claude (✱) icon and sign in with your Claude account.

Prefer the terminal — or want the claude command for the steps further down? Install the standalone CLI as well:

macOS or Linux

curl -fsSL https://claude.ai/install.sh | bash

Windows (paste into PowerShell)

irm https://claude.ai/install.ps1 | iex

The VS Code extension bundles its own copy for the chat panel, but the claude mcp add and export … && claude commands below run in a terminal and need this standalone install. Full guide: code.claude.com/docs/en/setup.

uv

Everything here runs through a tool called uv (its uvx command is what actually launches the server). You install it once. You do not need to install Python yourself — uv quietly downloads the right Python for you the first time it runs.

Open a terminal, copy the line for your computer, and paste it in:

macOS or Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (paste into PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

On a Mac that already has Homebrew, brew install uv works too.