Subotiz MCP

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)

Quick Start

Integration Guide

AI Developer

Developer Resources

Webhook

Prerequisites

Subotiz MCP URL

MCP Configuration

Tool List

​Prerequisites

​Subotiz MCP URL

​MCP Configuration

​Tool List

Prerequisites

Subotiz MCP URL

MCP Configuration

Tool List