Funraise MCP

Funraise MCP

MCP server for Funraise nonprofit fundraising - read and write your nonprofit's donor, donation, subscription, campaign site, household, and interaction data from Claude, Cursor, or any MCP client.

The first MCP for Funraise. The platform has 4.46 stars on Capterra with 114 reviews and powers thousands of mid-size to large nonprofits - the public REST API has had no first-party MCP wrapper and no Zapier/Composio/viaSocket integration.

You:   "How much did we bring in last month, and who were the top 5 new donors?"
Claude: *calls list_transactions with start_date, then list_supporters, summarizes the result*

You:   "Log this cash gift from the Patel family - $500, for the Year End campaign."
Claude: *calls create_supporter (if new) + create_transaction with the campaign site uuid*

You:   "Cancel Sarah's monthly subscription and email her a link to update her card instead."
Claude: *calls send_subscription_payment_update_email on the subscription, defers cancel*

Install

pip install -e .

Configure

# Get your API key in Funraise: Settings > API Keys > Generate API Key
export FUNRAISE_API_KEY="your-key-here"

The X-Api-Key header is the only authentication - no OAuth dance, no token rotation. One key per integration is the norm.

Plan limits

The client retries on 429 with exponential backoff + full jitter, honoring the Retry-After header.

Use with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "funraise-mcp": {
      "command": "funraise-mcp",
      "env": {
        "FUNRAISE_API_KEY": "your-key-here"
      }
    }
  }
}

Use with Claude Code

claude mcp add funraise-mcp -- funraise-mcp --env FUNRAISE_API_KEY=your-key-here

Tools (32 total)

Every tool raises on failure (so FastMCP sets isError: true on the wire response) and writes a JSONL audit record to stderr by default.

Use the Python client directly

import asyncio
from funraise_mcp import FunraiseClient

async def main():
    async with FunraiseClient() as c:
        # Find the most recent $5,000+ donation from this campaign
        txns = await c.list_transactions(
            limit=10,
            campaign_site_uuid="11111111-2222-3333-4444-555555555555",
            start_date="2026-06-01T00:00:00Z",
        )
        for txn in txns["items"]:
            if txn["amount"] >= 500000:  # cents
                print(f"Big gift: {txn['id']} - ${txn['amount']/100:.2f}")

asyncio.run(main())

Why this exists

• First MCP for Funraise - the public REST API at https://api.funraise.io (v1 + v2) has had no first-party MCP server, no Zapier wrapper, no Composio toolkit, no viaSocket integration. The only LobeHub "Skill" is a Membrane CLI integration - not a real MCP.
• Built for the conversations nonprofits actually have - "who gave last month?", "log this offline check", "send the Patels their 2025 giving summary", "merge these two duplicate household records". All one tool call away.
• Production-grade engineering - shared httpx.AsyncClient with connection pooling + transport retries, typed exception hierarchy with structured fields, application-level retry with exponential backoff + full jitter honoring Retry-After, JSONL audit logging, py.typed marker, ruff + mypy --strict clean, 30+ respx-based tests, 100+ property-based tests via hypothesis.

API quirks worth knowing

• Auth is one header - X-Api-Key: <key>. No OAuth, no token endpoint. Generate the key in Funraise > Settings > API Keys (you see it once - if lost, regenerate).
• Versioned base URL - all endpoints live under /api/v2/. v1 is still served for some old endpoints.
• Date fields are ISO 8601 - 2026-07-13T00:00:00Z. start_date/end_date filters on transaction lists accept these.
• Resource ids - most use numeric ids (supporters, transactions, subscriptions, households, addresses, interactions). Campaign sites use UUIDs.
• Errors - DRF-style {"detail": "..."} for 4xx, {"message": "..."} for some others, {"errors": {"field": [...]}} for validation. The client surfaces the most specific message on the typed exception.
• One supporter, one primary address, one household - Funraise's "Household" is the family/address-level grouping. "Supporter" is the individual donor. A supporter can be a member of one household.

Development

git clone https://github.com/sanjibani/funraise-mcp
cd funraise-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# Lint + type-check
ruff check src tests
ruff format --check src tests
mypy src

# Run the test suite
pytest         # 50+ respx-based endpoint tests + property tests

# Run the MCP server
funraise-mcp

Architecture

Built on the same template (mcp-vertical-template) that ships hawksoft-mcp, open-dental-mcp, ezyvet-mcp, jobber-mcp, practicepanther-mcp, cox-automotive-mcp, qualia-mcp, realm-mp-mcp, campspot-mcp, cleancloud-mcp, playmetrics-mcp, foreup-mcp, storedge-mcp, courtreserve-mcp, procare-mcp, and passare-mcp. Industry-leading patterns from encode/httpx, stripe-python, boto3, pydantic, authlib, pytest-dev, astral-sh/ruff, and hynek/structlog.

• Client (src/funraise_mcp/client.py) - async HTTP client with shared connection pool, transport retries, structured exception hierarchy, application-level retry with exponential backoff + full jitter.
• Server (src/funraise_mcp/server.py) - FastMCP server with bare-raise error handling (so isError: true is set on every failure - the Blackwell audit pattern), JSONL audit logging on every tool call.
• Exceptions (src/funraise_mcp/exceptions.py) - typed hierarchy (FunraiseAuthError, FunraiseNotFoundError, FunraiseRateLimitError, FunraiseAPIError, FunraiseConnectionError) with structured fields (http_status, error_code, request_id, retry_after).
• Audit (src/funraise_mcp/audit.py) - stdlib-only JSONL audit logger with secret redaction, fail-open sink, env-var-overridable file path.

License

MIT.

See also

• Funraise API docs
• Model Context Protocol spec
• MCP Python SDK
• awesome-mcp-servers
• Other vertical MCPs by sanjibani
• Custom MCP engagements