Subotiz MCP is an open toolset server based on the Model Context Protocol. AI agents can interact with Subotiz payment and subscription capabilities through standardized MCP tools (customers, products, pricing, subscriptions, trades, refunds, invoices, webhooks, and developer documentation lookup).
Learn more: For an overview of Subotiz products and capabilities, visit the Subotiz homepage.
Prerequisites
- A host that supports Streamable HTTP MCP (e.g. VS Code 1.101+, Claude Desktop, Cursor, Trae, etc.)
- A valid Subotiz access token
Subotiz MCP URL
- sandbox: https://api.sandbox.subotiz.com/mcp
- prod: https://api.subotiz.com/mcp
MCP Configuration
When connecting to the official hosted service, you only need to configure the URL and Authorization: Bearer; no other request headers are required.
Cursor example (add to Cursor’s MCP settings):
{
"mcpServers": {
"my-remote-server": {
"url": "{{MCP_URL}}",
"headers": {
"Authorization": "Bearer {{YOUR_TOKEN_HERE}}"
}
}
}
}Replace {{MCP_URL}} with the MCP URL for your target environment and {{YOUR_TOKEN_HERE}} with your Subotiz access token. In hosts such as VS Code, Cursor, or Claude Desktop, merge the above into their respective MCP configuration (e.g. servers or mcpServers) to use it.
Obtaining an API Key: The token in the configuration is your Subotiz API Key. For steps to create one and authentication details, see the Authentication guide.
Tool List
The full tool list (name, category, path, description) is maintained in a separate document for easier updates:
| Tool Name | Category | Path | Description |
|---|---|---|---|
create_customer | Customer | POST /api/v1/front/customer/create | Create a customer |
list_customer | Customer | GET /api/v1/front/customer | List customers |
list_products | Product | GET /api/v1/products | List products |
create_product | Product | POST /api/v1/products | Create a product |
list_prices | Pricing | GET /api/v1/prices | List prices |
create_price | Pricing | POST /api/v1/prices | Create a price |
list_subscription | Subscription | GET /api/v1/subscription | List subscriptions |
list_trades | Trade | GET /api/v1/trades | List trades |
list_refund | Refund | GET /api/v1/trades/:trade_id/refunds | List refunds by trade |
list_invoice | Invoice | GET /api/v1/invoices | List invoices |
list_webhook_event_v2 | Webhook | GET /api/v2/webhook/events | List webhook events (v2) |
get_llm_full_doc | Developer docs | - | Get full LLM documentation (llm-full.txt) |
get_llm_doc | Developer docs | - | Get condensed LLM documentation (llm.txt) |