MCP

The Giving v1 Model Context Protocol (MCP) server enables AI-powered code editors like Cursor and Windsurf, plus general-purpose tools like Claude Desktop, to interact directly with your Giving v1 API and documentation.

What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI applications to securely access external data sources and tools. The Giving v1 MCP server provides AI agents with:

Direct API access to Giving v1 functionality
Documentation search capabilities
Real-time data from your Giving v1 account
Code generation assistance for Giving v1 integrations

Giving v1 MCP Server Setup

Giving v1 hosts a remote MCP server at https://pushpay-givingv1.readme.io/mcp. Configure your AI development tools to connect to this server. If your APIs require authentication, you can pass in headers via query parameters or however headers are configured in your MCP client.

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "pushpay-givingv1": {
      "url": "https://pushpay-givingv1.readme.io/mcp"
    }
  }
}

Testing Your MCP Setup

Once configured, you can test your MCP server connection:

Open your AI editor (Cursor, Windsurf, etc.)
Start a new chat with the AI assistant
Ask about Giving v1 - try questions like:
- "How do I [common use case]?"
- "Show me an example of [API functionality]"
- "Create a [integration type] using Giving v1"

The AI should now have access to your Giving v1 account data and documentation through the MCP server.