{"_id":"@iflow-mcp/paddle-mcp-server","_rev":"3-6730d439373d3bd3e57fc2943b759fb0","name":"@iflow-mcp/paddle-mcp-server","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.2":{"name":"@iflow-mcp/paddle-mcp-server","version":"0.1.2","keywords":["mcp","modelcontextprotocol","paddle","billing"],"license":"Apache-2.0","_id":"@iflow-mcp/paddle-mcp-server@0.1.2","maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"homepage":"https://github.com/PaddleHQ/paddle-mcp-server#readme","bugs":{"url":"https://github.com/PaddleHQ/paddle-mcp-server/issues"},"bin":{"paddle":"build/index.js"},"dist":{"shasum":"57bedd380156a78adb9bb6e186a4e15ea8fb5dcd","tarball":"https://registry.npmjs.org/@iflow-mcp/paddle-mcp-server/-/paddle-mcp-server-0.1.2.tgz","fileCount":10,"integrity":"sha512-kkkpIduZWCGl3FaJ/TJ+UoNIynV5v1CNKmIUp4hmawgxM4rsuhzy+zpaNYwjEFtqxi5ZXqLqxMyaJwNlhoELHg==","signatures":[{"sig":"MEQCIBdXxlxPQTp9WR/zNgYYBr85dbc6nHKNRtc1wOasnIlhAiAdROIQMAmpqLFXimFpRqXBkRoBYEqZOvQ74XWPpHzDHQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48451},"main":"build/index.js","type":"module","gitHead":"02d57a3354063d6eddfc8057d4eb96d7db0ea5ca","scripts":{"dev":"tsc --watch","lint":"eslint src","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","format":"prettier --write src","lint:fix":"eslint src --fix","inspector":"npx @modelcontextprotocol/inspector build/index.js"},"_npmUser":{"name":"chatflowdev","email":"chatflowdev@gmail.com"},"repository":{"url":"git+https://github.com/PaddleHQ/paddle-mcp-server.git","type":"git"},"_npmVersion":"11.6.0","description":"MCP Server for Paddle Billing","directories":{},"_nodeVersion":"24.8.0","dependencies":{"zod":"^4.0.5","ts-node":"^10.9.2","typescript":"^5.8.2","@paddle/paddle-node-sdk":"^3.0.0","@modelcontextprotocol/sdk":"^1.7.0"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.23.0","globals":"^16.0.0","prettier":"^3.5.3","@eslint/js":"^9.23.0","@types/node":"^24.0.2","typescript-eslint":"^8.27.0"},"_npmOperationalInternal":{"tmp":"tmp/paddle-mcp-server_0.1.2_1761788479666_0.5187362691048116","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@iflow-mcp/paddle-mcp-server","version":"0.1.3","keywords":["mcp","modelcontextprotocol","paddle","billing"],"license":"Apache-2.0","_id":"@iflow-mcp/paddle-mcp-server@0.1.3","maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"homepage":"https://github.com/PaddleHQ/paddle-mcp-server#readme","bugs":{"url":"https://github.com/PaddleHQ/paddle-mcp-server/issues"},"bin":{"paddle":"build/index.js"},"dist":{"shasum":"78494dac8ab65179417dbebf1f1a1d1b5585c8ec","tarball":"https://registry.npmjs.org/@iflow-mcp/paddle-mcp-server/-/paddle-mcp-server-0.1.3.tgz","fileCount":10,"integrity":"sha512-T2or5NNjqhXT9vUFJ+K9/soB1OWG7XTK6o8mwVhuO+5KMGg7DuqZ3od60dpxLlp8af6GwOuWYhkrJAvuzs2O4A==","signatures":[{"sig":"MEQCICKurNjtrLOzTnoDtatZoS5uFYwh4UKndt8KicB0k6JoAiBzsVS83ny56y61AvYAOxUlXaW+F/1DIaPrJZSN/Scg3g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48451},"main":"build/index.js","type":"module","gitHead":"02d57a3354063d6eddfc8057d4eb96d7db0ea5ca","scripts":{"dev":"tsc --watch","lint":"eslint src","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","format":"prettier --write src","lint:fix":"eslint src --fix","inspector":"npx @modelcontextprotocol/inspector build/index.js"},"_npmUser":{"name":"chatflowdev","email":"chatflowdev@gmail.com"},"repository":{"url":"git+https://github.com/PaddleHQ/paddle-mcp-server.git","type":"git"},"_npmVersion":"11.6.0","description":"MCP Server for Paddle Billing","directories":{},"_nodeVersion":"24.8.0","dependencies":{"zod":"^4.0.5","ts-node":"^10.9.2","typescript":"^5.8.2","@paddle/paddle-node-sdk":"^3.0.0","@modelcontextprotocol/sdk":"^1.7.0"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.23.0","globals":"^16.0.0","prettier":"^3.5.3","@eslint/js":"^9.23.0","@types/node":"^24.0.2","typescript-eslint":"^8.27.0"},"_npmOperationalInternal":{"tmp":"tmp/paddle-mcp-server_0.1.3_1762155117589_0.4574030398149309","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@iflow-mcp/paddle-mcp-server","version":"0.1.4","description":"MCP Server for Paddle Billing","license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/PaddleHQ/paddle-mcp-server.git"},"main":"build/index.js","type":"module","bin":{"paddle":"build/index.js"},"scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","dev":"tsc --watch","inspector":"npx @modelcontextprotocol/inspector build/index.js","lint":"eslint src","lint:fix":"eslint src --fix","format":"prettier --write src"},"keywords":["mcp","modelcontextprotocol","paddle","billing"],"dependencies":{"@modelcontextprotocol/sdk":"^1.18.1","@paddle/paddle-node-sdk":"^3.0.0","ts-node":"^10.9.2","typescript":"^5.8.2","zod":"~3.25.76"},"devDependencies":{"@eslint/js":"^9.23.0","@types/node":"^24.0.2","eslint":"^9.23.0","globals":"^16.0.0","prettier":"^3.5.3","typescript-eslint":"^8.27.0"},"_id":"@iflow-mcp/paddle-mcp-server@0.1.4","gitHead":"e27ff981e8a42edf2dafcb6ec2f1f08f04a84a7f","bugs":{"url":"https://github.com/PaddleHQ/paddle-mcp-server/issues"},"homepage":"https://github.com/PaddleHQ/paddle-mcp-server#readme","_nodeVersion":"24.1.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-1jOxeBrIVpKJLZhzd6ABJOIpJBQITYIer7t/I2G1CJyRc6WbHHbsAFIUPmplI82Iy/AK5djtZp8fQeEujkFTew==","shasum":"a8078dceffa59d4a26d64c14c6f14e42cb2166be","tarball":"https://registry.npmjs.org/@iflow-mcp/paddle-mcp-server/-/paddle-mcp-server-0.1.4.tgz","fileCount":11,"unpackedSize":342195,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAee9uxTQRVDA280C7iT/A+LQl3+sojaG8AoZxP4seE6AiBAgs+4hk1fOL0Z4Y+peLVhN0vJqRWnNPMwn8JC5euklg=="}]},"_npmUser":{"name":"chatflowdev","email":"chatflowdev@gmail.com"},"directories":{},"maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/paddle-mcp-server_0.1.4_1762757800121_0.9526969617507017"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-30T01:41:19.542Z","modified":"2025-11-10T06:56:40.546Z","0.1.2":"2025-10-30T01:41:19.865Z","0.1.3":"2025-11-03T07:31:57.789Z","0.1.4":"2025-11-10T06:56:40.305Z"},"bugs":{"url":"https://github.com/PaddleHQ/paddle-mcp-server/issues"},"license":"Apache-2.0","homepage":"https://github.com/PaddleHQ/paddle-mcp-server#readme","keywords":["mcp","modelcontextprotocol","paddle","billing"],"repository":{"type":"git","url":"git+https://github.com/PaddleHQ/paddle-mcp-server.git"},"description":"MCP Server for Paddle Billing","maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"readme":"# MCP Server for Paddle Billing\n\n[Paddle Billing](https://www.paddle.com/billing?utm_source=dx&utm_medium=paddle-mcp-server) is the developer-first merchant of record. We take care of payments, tax, subscriptions, and metrics with one unified API that does it all.\n\nThis is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server that provides LLMs and AI agents with tools for interacting with the Paddle API.\n\n> **Important:** This MCP server works with Paddle Billing. It does not support Paddle Classic. To work with Paddle Classic, see: [Paddle Classic API reference](https://developer.paddle.com/classic/api-reference/1384a288aca7a-api-reference?utm_source=dx&utm_medium=paddle-mcp-server)\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=paddle&config=eyJjb21tYW5kIjoibnB4IC15IEBwYWRkbGUvcGFkZGxlLW1jcCIsImVudiI6eyJQQURETEVfQVBJX0tFWSI6InBkbF9zZGJ4X2FwaWtleV8iLCJQQURETEVfRU5WSVJPTk1FTlQiOiJzYW5kYm94In19)\n\n## Features\n\nThe MCP server has near parity with the Paddle API, allowing AI assistants and agents to:\n\n* Manage your full Paddle catalog\n* View customer, purchase, and provisioning information\n* Handle subscription, payment, and refund workflows\n* Debug billing and order management issues\n* Create and adjust transactions directly in conversation\n* Generate financial reports for financial and operational insights\n* Implement and test Paddle integrations faster\n\n<details>\n<summary>Available tools</summary>\n\n### Products\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List products | `list_products` | ✅ | ✅ |\n| Create a product | `create_product` | ✅ | ❌ |\n| Get a product | `get_product` | ✅ | ✅ |\n| Update a product | `update_product` | ❌ | ❌ |\n\n### Prices\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List prices | `list_prices` | ✅ | ✅ |\n| Create a price | `create_price` | ✅ | ❌ |\n| Get a price | `get_price` | ✅ | ✅ |\n| Update a price | `update_price` | ❌ | ❌ |\n| Preview prices | `preview_prices` | ✅ | ❌ |\n\n### Discounts\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List discounts | `list_discounts` | ✅ | ✅ |\n| Create a discount | `create_discount` | ✅ | ❌ |\n| Get a discount | `get_discount` | ✅ | ✅ |\n| Update a discount | `update_discount` | ❌ | ❌ |\n\n### Discount Groups\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List discount groups | `list_discount_groups` | ✅ | ✅ |\n| Create a discount group | `create_discount_group` | ✅ | ❌ |\n| Get a discount group | `get_discount_group` | ✅ | ✅ |\n| Update a discount group | `update_discount_group` | ❌ | ❌ |\n| Archive a discount group | `archive_discount_group` | ❌ | ❌ |\n\n### Customers\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List customers | `list_customers` | ✅ | ✅ |\n| Create a customer | `create_customer` | ✅ | ❌ |\n| Get a customer | `get_customer` | ✅ | ✅ |\n| Update a customer | `update_customer` | ❌ | ❌ |\n| List credit balances for a customer | `list_credit_balances` | ✅ | ✅ |\n\n### Addresses\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List addresses for a customer | `list_addresses` | ✅ | ✅ |\n| Create an address for a customer | `create_address` | ✅ | ❌ |\n| Get an address for a customer | `get_address` | ✅ | ✅ |\n| Update an address for a customer | `update_address` | ❌ | ❌ |\n\n### Businesses\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List businesses for a customer | `list_businesses` | ✅ | ✅ |\n| Create a business for a customer | `create_business` | ✅ | ❌ |\n| Get a business for a customer | `get_business` | ✅ | ✅ |\n| Update a business for a customer | `update_business` | ❌ | ❌ |\n\n### Transactions\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List transactions | `list_transactions` | ✅ | ✅ |\n| Create a transaction | `create_transaction` | ✅ | ❌ |\n| Get a transaction | `get_transaction` | ✅ | ✅ |\n| Update a transaction | `update_transaction` | ❌ | ❌ |\n| Preview a transaction | `preview_transaction_create` | ✅ | ❌ |\n| Revise customer information on a billed or completed transaction | `revise_transaction` | ❌ | ❌ |\n| Get a PDF invoice for a transaction | `get_transaction_invoice` | ✅ | ✅ |\n\n### Adjustments\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List adjustments | `list_adjustments` | ✅ | ✅ |\n| Create an adjustment | `create_adjustment` | ✅ | ❌ |\n| Get a PDF credit note for an adjustment | `get_adjustment_credit_note` | ✅ | ✅ |\n\n### Subscriptions\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List subscriptions | `list_subscriptions` | ✅ | ✅ |\n| Get a subscription | `get_subscription` | ✅ | ✅ |\n| Update a subscription | `update_subscription` | ❌ | ❌ |\n| Cancel a subscription | `cancel_subscription` | ❌ | ❌ |\n| Pause a subscription | `pause_subscription` | ❌ | ❌ |\n| Resume a paused subscription | `resume_subscription` | ❌ | ❌ |\n| Activate a trialing subscription | `activate_subscription` | ❌ | ❌ |\n| Preview an update to a subscription | `preview_subscription_update` | ✅ | ❌ |\n| Create a one-time charge for a subscription | `create_subscription_charge` | ✅ | ❌ |\n| Preview a one-time charge for a subscription | `preview_subscription_charge` | ✅ | ❌ |\n\n### Saved Payment Methods\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List payment methods saved for a customer | `list_saved_payment_methods` | ✅ | ✅ |\n| Get a payment method saved for a customer | `get_saved_payment_method` | ✅ | ✅ |\n| Delete a payment method saved for a customer | `delete_saved_payment_method` | ❌ | ❌ |\n\n### Customer Portal Sessions\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| Create a customer portal session | `create_customer_portal_session` | ✅ | ❌ |\n\n### Notification Settings\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List notification settings | `list_notification_settings` | ✅ | ✅ |\n| Create a notification setting | `create_notification_setting` | ✅ | ❌ |\n| Get a notification setting | `get_notification_setting` | ✅ | ✅ |\n| Update a notification setting | `update_notification_setting` | ❌ | ❌ |\n| Delete a notification setting | `delete_notification_setting` | ❌ | ❌ |\n\n### Events\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List events | `list_events` | ✅ | ✅ |\n\n### Notifications\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List notifications | `list_notifications` | ✅ | ✅ |\n| Get a notification | `get_notification` | ✅ | ✅ |\n| Replay a notification | `replay_notification` | ✅ | ❌ |\n\n### Notification Logs\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List logs for a notification | `list_notification_logs` | ✅ | ✅ |\n\n### Simulations\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List simulations | `list_simulations` | ✅ | ✅ |\n| Create a simulation | `create_simulation` | ✅ | ❌ |\n| Get a simulation | `get_simulation` | ✅ | ✅ |\n| Update a simulation | `update_simulation` | ❌ | ❌ |\n\n### Simulation Runs\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List runs for a simulation | `list_simulation_runs` | ✅ | ✅ |\n| Create a run for a simulation | `create_simulation_run` | ✅ | ❌ |\n| Get a run for a simulation | `get_simulation_run` | ✅ | ✅ |\n\n### Simulation Run Events\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List events for a simulation run | `list_simulation_run_events` | ✅ | ✅ |\n| Get an event for a simulation run | `get_simulation_run_event` | ✅ | ✅ |\n| Replay an event for a simulation run | `replay_simulation_run_event` | ✅ | ❌ |\n\n### Reports\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List reports | `list_reports` | ✅ | ✅ |\n| Create a report | `create_report` | ✅ | ❌ |\n| Get a report | `get_report` | ✅ | ✅ |\n| Get a CSV file for a report | `get_report_csv` | ✅ | ✅ |\n\n### Client-Side Tokens\n\n| Operation | Tool | Non-destructive | Read only |\n|-----------|------|-----------------|-----------|\n| List client-side tokens | `list_client_side_tokens` | ✅ | ✅ |\n| Create a client-side token | `create_client_side_token` | ✅ | ❌ |\n| Get a client-side token | `get_client_side_token` | ✅ | ✅ |\n| Revoke a client-side token | `revoke_client_side_token` | ❌ | ❌ |\n\n</details>\n\n## Installation\n\nTo use the MCP server, you'll need an API key. You can create and manage API keys in **Paddle > Developer tools > Authentication**:\n\n- Sandbox: https://sandbox-vendors.paddle.com/authentication-v2\n- Live: https://vendors.paddle.com/authentication-v2\n\nTo run the server in a client like Claude Desktop, Cursor or Windsurf, add the following to your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"paddle\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@paddle/paddle-mcp\", \"--api-key=PADDLE_API_KEY\", \"--environment=(sandbox|production)\", \"--tools=(all|read-only|non-destructive|tool_name1,tool_name2,...)\"]\n    }\n  }\n}\n```\n\nReplace `PADDLE_API_KEY` with your API key, and pass the correct value as `environment`.\n\nYou can also filter the tools available to the MCP server by passing the `--tools` argument. Accepted values are `all`, `read-only`, `non-destructive`, or a comma-separated list of tool names. The default is `non-destructive`.\n\nFor detailed setup guides, see:\n\n- [Claude Desktop](https://modelcontextprotocol.io/quickstart/user)\n- [Cursor](https://docs.cursor.com/context/model-context-protocol)\n- [Windsurf](https://docs.codeium.com/windsurf/mcp)\n\n## Development\n\n1. Install dependencies:\n\n   ```bash\n   pnpm install\n   ```\n\n2. Build the server:\n\n   ```bash\n   pnpm build\n   ```\n\n3. Update client to use the local build:\n   ```json\n   {\n     \"mcpServers\": {\n       \"paddle\": {\n         \"command\": \"node\",\n         \"args\": [\"path/to/paddle-mcp-server/build/index.js\"],\n         \"env\": {\n           \"PADDLE_API_KEY\": \"your_api_key\",\n           \"PADDLE_ENVIRONMENT\": \"sandbox\",\n           \"PADDLE_MCP_TOOLS\": \"all\"\n         }\n       }\n     }\n   }\n   ```\n\n   The `PADDLE_MCP_TOOLS` environment variable accepts the same values as the `--tools` argument: `all`, `read-only`, `non-destructive`, or a comma-separated list of tool names. If not set, defaults to `non-destructive`.\n\n## Debugging\n\nTo debug the MCP server, you can use the MCP Inspector tool:\n\n1. Run the server with the inspector:\n\n   ```bash\n   pnpm inspector\n   ```\n\n2. Open the provided URL in your browser to view and debug the MCP requests and responses.\n\n3. Include the `--api-key` and `--environment` arguments.\n\n## Learn more\n\n- [Paddle developer docs](https://developer.paddle.com?utm_source=dx&utm_medium=paddle-mcp-server)\n- [Paddle API reference](https://developer.paddle.com/api-reference/overview?utm_source=dx&utm_medium=paddle-mcp-server)\n- [Sign up for Paddle Billing](https://login.paddle.com/signup?utm_source=dx&utm_medium=paddle-mcp-server)\n","readmeFilename":"README.md"}