Paddle (Sandbox) — Claude Code MCP server: setup and features
Paddle (Sandbox) is an MCP server for Claude Code that connects an AI agent to Paddle Billing's sandbox. It can test prices, subscriptions, payments, and webhooks.
Apache-2.0 updated 2026-11-03
claude mcp add --transport http paddle-sandbox https://sandbox-mcp.paddle.com/mcpWhat Paddle (Sandbox) does
The server exposes Paddle sandbox operations for products, prices, subscriptions, customers, and transactions. Its search tool looks up API reference material, while execute runs chained API calls against the test environment. Name the connection paddle-sandbox to direct the agent to sandbox operations.
Paddle hosts the server, so there is no server process to install or run locally. Authentication requires a sandbox API key beginning with pdl_sdbx_, sent in the Authorization header. OAuth is not supported for sandbox connections. A further tool can render interactive metric charts in clients that support MCP Apps.
What it helps with
- test product and price creation in Paddle’s sandbox
- exercise a subscription or payment flow
- run chained API operations against the test environment
- chart metrics in an MCP Apps-compatible client
Example prompts for the agent
- Use
paddle-sandboxto create a Pro test plan priced at $79 per month with a 14-day trial. - Show me the products and prices in the test environment through
paddle-sandbox. - Use
paddle-sandboxto chart revenue by week for the last 3 months.
How to install Paddle (Sandbox)
Platform CLI: remote server
claude mcp add --transport http paddle-sandbox https://sandbox-mcp.paddle.com/mcpPlatform CLI: remote server
codex mcp add paddle-sandbox --url https://sandbox-mcp.paddle.com/mcpConfig file
{
"mcpServers": {
"paddle-sandbox": {
"url": "https://sandbox-mcp.paddle.com/mcp"
}
}
}Config file
{
"servers": {
"paddle-sandbox": {
"type": "http",
"url": "https://sandbox-mcp.paddle.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http paddle-sandbox https://sandbox-mcp.paddle.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Paddle (Sandbox)
How do I install Paddle (Sandbox) in Claude Code?
Add the server with claude mcp add --transport http paddle-sandbox https://sandbox-mcp.paddle.com/mcp. Provide a sandbox API key in the Authorization header to authenticate.
What does Paddle (Sandbox) do?
It connects an AI agent to Paddle Billing’s test environment, where the agent can look up API reference material and run sandbox operations.
What does Paddle (Sandbox) need to work?
It requires a sandbox API key beginning with pdl_sdbx_, sent in the Authorization header. Sandbox connections do not support OAuth.