opencollective

Open Collective

Query and manage Open Collective accounts, finances, and community data via their public GraphQL API v2.

Endpoint & Auth

• Endpoint: https://api.opencollective.com/graphql/v2
• Unauthenticated: 10 req/min, public read-only
• Authenticated: 100 req/min — pass Personal-Token: <token> header
• Token creation: https://opencollective.com/<your-slug>/admin/for-developers
• Not available via API: Stripe/PayPal payment creation, captcha-protected operations

MCP Server Setup

Use mcp-graphql to expose the OC API as MCP tools. With fnox-backed auth:

claude mcp add opencollective-graphql -- /bin/sh -c \
  'unset PYTHONPATH && \
   ENDPOINT=https://api.opencollective.com/graphql/v2 \
   HEADERS="{\"Personal-Token\":\"$(fnox get OPENCOLLECTIVE_TOKEN --age-key-file ~/.age/key.txt -c ~/v/instance-onboarding/fnox.toml)\"}" \
   exec npx mcp-graphql'

Store your token: fnox set OPENCOLLECTIVE_TOKEN <token> --age-key-file ~/.age/key.txt -c ~/v/instance-onboarding/fnox.toml

Quick Start

If opencollective-graphql MCP server is available, use its query-graphql tool. Otherwise use curl.

query { account(slug: "webpack") { name stats { balance { valueInCents currency } } } }

Core Queries

Core Mutations (all require auth)

Reference Guide

Key Patterns

• Pagination: All collections use limit/offset, return totalCount + nodes
• Account refs: {slug: "x"}, {id: "uuid"}, or {legacyId: 123}
• Amounts: Always { valueInCents: Int, currency: String } — divide by 100 for display
• See references/queries.md for full filtering examples

Account Types

COLLECTIVE, ORGANIZATION, INDIVIDUAL, FUND, EVENT, PROJECT, HOST, VENDOR

Status Enums

• Expense: DRAFT → UNVERIFIED → PENDING → APPROVED → PROCESSING → PAID (also REJECTED, ERROR, CANCELED)
• Order: NEW, PENDING, ACTIVE, CANCELLED, REJECTED, PAID, ERROR, EXPIRED
• Transaction type: CREDIT (in) / DEBIT (out)
• Transaction kind: CONTRIBUTION, EXPENSE, ADDED_FUNDS, HOST_FEE, PAYMENT_PROCESSOR_FEE, PLATFORM_FEE

Tips

• stats subfields on accounts give quick financial summaries
• members(role: [BACKER]) lists financial contributors
• tiers shows sponsorship levels; updates shows blog posts
• socialLinks has website, twitter, github URLs