# Donately — how to use (mcp.ai)

Connect your Donately account and use 10 tools for fundraising straight from your AI agent. Connect with your own API key. Donately is a fundraising platform for managing campaigns, donations, recurring giving, donors, forms, fundraisers, and webhooks.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_donately?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `donately_get_current_account`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/donately`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/donately/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/donately/get/current/account` — Return the Donately account associated with the connected API token, including its identity, currency, status, and billing plan.
- `POST https://api.mcp.ai/api/donately/get/form` — Return a specific Donately donation form and its embedded configuration by form ID.
  - body: { form_id: string }
- `POST https://api.mcp.ai/api/donately/get/person` — Return a specific Donately donor or contact by person ID.
  - body: { person_id: string }
- `POST https://api.mcp.ai/api/donately/list/campaigns` — List campaigns in the connected Donately account, optionally filtering by publication state, type, keyword, or fundraiser availability.
  - body: { limit?: integer, cursor?: string, status?: string, keyword?: string, campaign_type?: string, has_fundraisers?: boolean }
- `POST https://api.mcp.ai/api/donately/list/donations` — List donation records in the connected account and filter them by status, related donor or fundraising resource, payment type, or other common attributes.
  - body: { limit?: integer, cursor?: string, status?: string, keyword?: string, currency?: string, anonymous?: boolean, person_id?: string, recurring?: boolean, campaign_id?: string, donation_type?: string, fundraiser_id?: string, amount_in_cents?: integer }
- `POST https://api.mcp.ai/api/donately/list/forms` — List donation forms in the connected Donately account, including default-form and form configuration information returned by Donately.
  - body: { limit?: integer, cursor?: string }
- `POST https://api.mcp.ai/api/donately/list/fundraisers` — List peer-to-peer fundraisers in the connected Donately account, optionally limited to one campaign.
  - body: { limit?: integer, cursor?: string, campaign_id?: string }
- `POST https://api.mcp.ai/api/donately/list/people` — List donors and contacts in the connected Donately account, optionally searching by keyword.
  - body: { limit?: integer, cursor?: string, keyword?: string }
- `POST https://api.mcp.ai/api/donately/list/subscriptions` — List recurring donation subscriptions in the connected Donately account.
  - body: { limit?: integer, cursor?: string }
- `POST https://api.mcp.ai/api/donately/list/webhooks` — List webhook registrations configured for the connected Donately account.
  - body: { limit?: integer, cursor?: string }

## Example prompts
- "What can I do in Donately?"
- "Show me a summary of my Donately account"

## More
- Page: https://mcp.ai/donately
- Agent spec (llms.txt): https://mcp.ai/donately/llms.txt
- Postman collection: https://mcp.ai/donately/postman.json