Give AI assistants up-to-date Paddle knowledge
Connect AI assistants to all current Paddle content and resources using the Paddle Docs MCP server.
The Paddle Docs MCP server gives AI assistants full, current knowledge of Paddle to help you build, integrate, and troubleshoot without relying on outdated training data.
The Paddle Docs MCP server is subject to changes as an AI feature under development.
How it works
AI assistants are only as good as what they know. Without access to the latest documentation, they can give outdated advice, miss important details, or confidently suggest things that are no longer accurate.
Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external services to access real-time data and take actions. Think of it as a plugin that gives your AI assistant access to a specific source of knowledge or capability.
The Paddle Docs MCP server is that plugin for Paddle knowledge. You only need to install it once, and your AI assistant can search and reference up-to-date Paddle resources, like:
Paddle documentation
All of the guides and references published at developer.paddle.com.
OpenAPI specification
The full, current Paddle API specification, including all endpoints, parameters, response shapes, and webhooks.
This is useful whether you're integrating Paddle, debugging unexpected behavior, or just curious about what Paddle is and how it works. We recommend installing it in every AI assistant you use to avoid guesswork and always get accurate answers.
The Paddle Docs MCP server gives your AI assistant knowledge of Paddle. If you want your assistant to take actions in your Paddle account, like creating your catalog, listing customers, or managing subscriptions, you'll also want to set up the Paddle MCP server.
Install the MCP server
Setting up the Paddle Docs MCP server varies slightly depending on which AI client you're using.
The server runs remotely using Kapa.ai.
Open Claude Desktop and go to Settings > Developer.
Click Edit Config and open the
claude_desktop_config.jsonfile.Add the
paddle-docsserver configuration to themcpServersobject.Save the file and restart Claude Desktop.
123456781{
2 "mcpServers": {
3 "paddle-docs": {
4 "type": "http",
5 "url": "https://paddlehq.mcp.kapa.ai"
6 }
7 }
8}Once installed, you may be prompted to authenticate with Kapa.ai. This authentication is necessary to check you're not a bot and to keep the service reliable and secure for everyone.
Authentication through Kapa.ai can happen more than once. Some AI clients automatically prompt, but others may require manual action. For example, Cursor requires you to check in Settings > MCP Tools and to click Authenticate if action is required.
Use the MCP server
Once installed, the Paddle Docs MCP server works quietly in the background. You can ask your AI assistant about Paddle and it'll search automatically when it needs to, with no additional configuration.
Most AI assistants show you when an MCP server is used. If you can't see this, ask your assistant to use up-to-date information from the Paddle documentation. This encourages it to search using the MCP server tool rather than rely on its training data.
Example prompts
11Using the latest Paddle documentation, what's the correct way to verify a webhook signature with my current Node.js implementation?Combine with the Paddle MCP to take actions in your account to integrate even faster, like creating your product catalog, setting up client-side tokens and notification destinations, and simulating webhooks to test your implementation.
11Check the Paddle docs and tell me which fields I need to include when creating a one-time charge on an existing subscription.11Looking at the current Paddle documentation, what are the most likely causes of a `too_many_requests` error when calling the transactions endpoint, and how should I handle it?Combine with the Paddle MCP to debug issues using your actual account data, like when integrating Paddle with client-side tokens and notification information, or when investigating customer issues with transactions, subscriptions, or any Paddle events that occurred.
11Based on the current Paddle docs, what are the main differences between Paddle Classic and Paddle Billing, and what would I need to update in my existing integration to migrate?This is especially powerful when you ask the AI assistant in your IDE where your existing payment and billing infrastructure lives, giving you a contextual plan of action. Combine with the Paddle MCP after you've planned to easily create non-sensitive entities in Paddle Billing for migration.
11Using up-to-date Paddle documentation, plan how to add an overlay, one-page Paddle Checkout to my existing Next.js pricing page.11Using up-to-date Paddle documentation, give me detailed instructions on how to open a customer portal for my customers to manage their subscriptions.11Check the Paddle docs. What's the difference between Paddle Classic and Paddle Billing?