Paddle
A Model Context Protocol server that provides tools for interacting with the Paddle Billing API, enabling users to manage products, prices, customers, transactions, subscriptions, and create custom financial reports.
What is Paddle?
Paddle is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that provides tools for interacting with the paddle billing api, enabling users to manage products, prices, customers, transactions, subscriptions, and create custom fina...
A Model Context Protocol server that provides tools for interacting with the Paddle Billing API, enabling users to manage products, prices, customers, transactions, subscriptions, and create custom financial reports.
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that provides tools for inte
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @paddle/paddle-mcpManual Installation
npx -y @paddle/paddle-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Paddle
The Paddle MCP Server connects AI assistants directly to the Paddle Billing API, exposing 80+ operations spanning products, prices, customers, transactions, subscriptions, adjustments, and financial reports. It lets you manage your entire billing stack through natural language — from creating subscription plans to investigating failed payments — without switching between dashboards. Teams use it to streamline revenue operations, automate subscription workflows, and generate ad-hoc financial reports on demand.
Prerequisites
- Node.js 18+ installed (for npx)
- A Paddle account with an API key (sandbox or production)
- Your Paddle API key from the Paddle Dashboard under Developer Tools
- An MCP client such as Claude Desktop, Cursor, or VS Code with MCP support
Obtain your Paddle API key
Log in to your Paddle Dashboard, navigate to Developer Tools > Authentication, and generate an API key. Use a sandbox key for testing and a production key for live data. Keep this key secure as it grants full billing access.
Test the server with npx
Verify the package is accessible before configuring your MCP client. This command starts the server in stdio mode and will print version information if successful.
npx -y @paddle/paddle-mcpAdd the server to your MCP client configuration
Open your MCP client config file (e.g. claude_desktop_config.json for Claude Desktop) and add the Paddle server entry with your credentials. Set PADDLE_ENVIRONMENT to 'sandbox' during development.
{
"mcpServers": {
"paddle": {
"command": "npx",
"args": ["-y", "@paddle/paddle-mcp"],
"env": {
"PADDLE_API_KEY": "your_paddle_api_key_here",
"PADDLE_ENVIRONMENT": "sandbox",
"PADDLE_MCP_TOOLS": "non-destructive"
}
}
}
}Choose a tool access level
Control which operations are exposed via PADDLE_MCP_TOOLS. Use 'read-only' to prevent any writes, 'non-destructive' (default) for reads plus safe writes, or 'all' for complete access including deletions and cancellations.
# Options for PADDLE_MCP_TOOLS:
# read-only — query operations only
# non-destructive — reads + safe creates/updates (default)
# all — every operation including deletes
# create-product,list-customers — comma-separated specific toolsRestart your MCP client and verify connection
Restart Claude Desktop (or your chosen client) so it picks up the new configuration. The Paddle server should appear in the connected MCP servers list. Try asking a simple query like listing your products to confirm the connection.
Paddle Examples
Client configuration
Full claude_desktop_config.json entry for the Paddle MCP server with sandbox credentials and non-destructive tool mode.
{
"mcpServers": {
"paddle": {
"command": "npx",
"args": ["-y", "@paddle/paddle-mcp"],
"env": {
"PADDLE_API_KEY": "live_apikey_xxxxxxxxxxxxxxxxxxxx",
"PADDLE_ENVIRONMENT": "production",
"PADDLE_MCP_TOOLS": "non-destructive"
}
}
}
}Prompts to try
Example natural language queries you can send once the Paddle MCP server is connected.
- "List all active subscription plans and their prices"
- "Show me all failed transactions from the last 7 days"
- "Create a new product called 'Pro Plan' priced at $49/month"
- "How many customers cancelled their subscriptions this month?"
- "Pause the subscription for customer ID ctm_01abc123 and send them a notification"
- "Generate a revenue report for Q1 grouped by product"Troubleshooting Paddle
Authentication error: 'Invalid API key' when starting the server
Verify that PADDLE_API_KEY is set correctly and matches the environment — sandbox keys won't work with PADDLE_ENVIRONMENT=production and vice versa. Check for extra spaces or newlines in the key value.
Tool not found or operation blocked
If a specific tool is unavailable, check your PADDLE_MCP_TOOLS setting. Destructive operations like cancelling subscriptions require 'all' mode. You can also pass a comma-separated list of specific tool names to enable exactly what you need.
npx fails with 'command not found' or network error
Ensure Node.js 18+ is installed and npx is on your PATH. If behind a corporate proxy, set the HTTPS_PROXY environment variable. You can also install the package globally first: npm install -g @paddle/paddle-mcp
Frequently Asked Questions about Paddle
What is Paddle?
Paddle is a Model Context Protocol (MCP) server that model context protocol server that provides tools for interacting with the paddle billing api, enabling users to manage products, prices, customers, transactions, subscriptions, and create custom financial reports. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Paddle?
Install via npm with the command: npx -y @paddle/paddle-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Paddle?
Paddle works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Paddle free to use?
Yes, Paddle is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Paddle Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Paddle? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Paddle in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Paddle?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.