# Daffy — how to use (mcp.ai)

Connect your Daffy account and use 12 tools for fundraising straight from your AI agent. Connect with your own API key. Daffy is a modern platform for charitable giving, offering a donor-advised fund that allows users to set money aside, watch it grow tax-free, and donate to over 1.7 million charities in the U.S.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_daffy?ms=1787295900000`
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. `daffy_create_gift`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/daffy`
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/daffy/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/daffy/create/gift` — Tool to create a new charitable gift. Use when you have recipient details and amount ready.
  - body: { name: string, amount: integer }
- `POST https://api.mcp.ai/api/daffy/get/balance` — Retrieve the authenticated user's Daffy fund balance information. Returns four key financial metrics: - Total fund amount - Pending deposits (not yet processed) - Portfolio balance (invested funds) - 
- `POST https://api.mcp.ai/api/daffy/get/contributions` — Retrieves paginated list of contributions made to the authenticated user's Daffy donor-advised fund (DAF). Contributions are private - this endpoint only returns contributions associated with the auth
  - body: { page?: integer }
- `POST https://api.mcp.ai/api/daffy/get/donations` — Retrieves the authenticated user's donation history from their Daffy account. Returns detailed information about each donation including amount, status, recipient nonprofit, fund details, and donation
  - body: { limit?: integer, offset?: integer, created_after?: string, created_before?: string }
- `POST https://api.mcp.ai/api/daffy/get/gift/by/code` — Tool to retrieve details of a specific gift by its unique code. Use after obtaining the gift code.
  - body: { code: string }
- `POST https://api.mcp.ai/api/daffy/get/gifts` — Retrieve a paginated list of gifts associated with the user's Daffy account. Returns gifts with details including recipient name, amount, status, and shareable URLs. Supports pagination using limit an
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/daffy/get/non/profit/by/ein2` — Tool to retrieve detailed information about a non-profit organization by its EIN. Use when you need comprehensive non-profit details including location coordinates and causes.
  - body: { ein: string }
- `POST https://api.mcp.ai/api/daffy/get/user/by/username` — Tool to retrieve a user's public profile information by username. Use when you need details about a specific user's account.
  - body: { username: string }
- `POST https://api.mcp.ai/api/daffy/get/user/causes` — Retrieves the list of charitable causes associated with a user's Daffy fund. Use this action to discover which causes a user supports. The user_id can be obtained from the Get User Profile action. Ret
  - body: { user_id: integer|string }
- `POST https://api.mcp.ai/api/daffy/get/user/donations` — Tool to retrieve public donations for a specific user by user ID. Use when you need to see a user's donation history. Limited to publicly visible donations only.
  - body: { page?: integer, user_id: integer }
- `POST https://api.mcp.ai/api/daffy/get/user/profile` — Tool to retrieve the authenticated user's profile. Use when you need details about the current user's account.
- `POST https://api.mcp.ai/api/daffy/search/non/profits` — Tool to search non-profit organizations by cause ID and query text. Use when you need to find nonprofits matching a search term or a specific cause.
  - body: { limit?: integer, query?: string, offset?: integer, cause_id?: string }

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

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