Mcp Server For Paddle Billing

What is Paddle MCP Server?

Paddle MCP Server is a powerful tool designed to facilitate interactions with the Paddle API. It allows developers to manage various aspects of their Paddle accounts, including product catalogs, billing, subscriptions, and reporting. This server acts as a bridge between your applications and Paddle's services, enabling seamless integration and automation of tasks.

Features of Paddle MCP Server

• API Integration: Easily connect with the Paddle API to perform operations such as creating products, managing subscriptions, and handling payments.
• AI Assistant Compatibility: Interact with Paddle using AI assistants like Claude or through AI-powered IDEs like Cursor, enhancing productivity and efficiency.
• Comprehensive Management: Manage your entire product catalog, billing processes, and subscription models from a single interface.
• Reporting Tools: Generate detailed reports to analyze sales, customer behavior, and other key metrics to make informed business decisions.
• Open Source: Paddle MCP Server is publicly available, allowing developers to contribute to its development and customize it to meet their specific needs.

How to Use Paddle MCP Server

1. Installation: Begin by cloning the repository from GitHub. Use the command:

   git clone https://github.com/PaddleHQ/paddle-mcp-server.git
   

2. Configuration: Set up your Paddle API keys and configure the server settings according to your requirements.
3. Running the Server: Launch the server using the appropriate command for your environment. Ensure that all dependencies are installed.
4. API Calls: Utilize the provided API endpoints to interact with Paddle. You can create, read, update, and delete resources as needed.
5. Monitoring and Reporting: Use the built-in reporting tools to monitor your sales and subscriptions, making adjustments as necessary.

Frequently Asked Questions

Q: What programming languages does Paddle MCP Server support?

A: Paddle MCP Server is designed to be language-agnostic, allowing integration with any programming language that can make HTTP requests.

Q: Is Paddle MCP Server free to use?

A: Yes, Paddle MCP Server is open-source and free to use. You can modify and distribute it under the terms of the Apache-2.0 license.

Q: Can I contribute to Paddle MCP Server?

A: Absolutely! Contributions are welcome. You can submit issues, feature requests, or pull requests on the GitHub repository.

Q: How do I report a bug?

A: If you encounter any issues, please report them on the GitHub issues page of the Paddle MCP Server repository.

Q: Where can I find more documentation?

A: Additional documentation and resources can be found on the Paddle Developer Portal.

MCP Server for Paddle Billing

Paddle Billing is the developer-first merchant of record. We take care of payments, tax, subscriptions, and metrics with one unified API that does it all.

This is a Model Context Protocol (MCP) server that provides tools for interacting with the Paddle API.

Important: This MCP server works with Paddle Billing. It does not support Paddle Classic. To work with Paddle Classic, see: Paddle Classic API reference

Features

• List products in your Paddle catalog
• Create new products
• List prices for products
• Create new prices for products
• List customers
• List transactions
• List subscriptions
• Create custom reports for financial analysis

Installation

To use the MCP server, you'll need an API key. You can create and manage API keys in Paddle > Developer tools > Authentication:

• Sandbox: https://sandbox-vendors.paddle.com/authentication-v2
• Live: https://vendors.paddle.com/authentication-v2

To run the server in a client like Claude Desktop, Cursor or Windsurf, add the following to your MCP config:

{
  "mcpServers": {
    "paddle": {
      "command": "npx",
      "args": ["-y", "@paddle/paddle-mcp", "--api-key=PADDLE_API_KEY", "--environment=(sandbox|production)"]
    }
  }
}

Replace PADDLE_API_KEY with your API key, and pass the correct value as environment.

For detailed setup guides, see:

• Claude Desktop
• Cursor
• Windsurf

Development

1. Install dependencies:

   pnpm install
   

2. Build the server:

   pnpm build
   

3. Update client to use the local build:

   {
     "mcpServers": {
       "paddle": {
         "command": "node",
         "args": ["path/to/paddle-mcp-server/build/index.js"],
         "env": {
           "PADDLE_API_KEY": "your_api_key",
           "PADDLE_ENVIRONMENT": "sandbox"
         }
       }
     }
   }
   

Debugging

To debug the MCP server, you can use the MCP Inspector tool:

1. Run the server with the inspector:

   pnpm inspector
   

2. Open the provided URL in your browser to view and debug the MCP requests and responses.

3. Include the --api-key and --environment arguments.

Learn more

• Paddle developer docs
• Paddle API reference
• Sign up for Paddle Billing