API Reference
API Reference

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

  1. A host that supports Streamable HTTP MCP (e.g. VS Code 1.101+, Claude Desktop, Cursor, Trae, etc.)
  2. A valid Subotiz access token

Subotiz MCP URL

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 NameCategoryPathDescription
create_customerCustomerPOST /api/v1/front/customer/createCreate a customer
list_customerCustomerGET /api/v1/front/customerList customers
list_productsProductGET /api/v1/productsList products
create_productProductPOST /api/v1/productsCreate a product
list_pricesPricingGET /api/v1/pricesList prices
create_pricePricingPOST /api/v1/pricesCreate a price
list_subscriptionSubscriptionGET /api/v1/subscriptionList subscriptions
list_tradesTradeGET /api/v1/tradesList trades
list_refundRefundGET /api/v1/trades/:trade_id/refundsList refunds by trade
list_invoiceInvoiceGET /api/v1/invoicesList invoices
list_webhook_event_v2WebhookGET /api/v2/webhook/eventsList webhook events (v2)
get_llm_full_docDeveloper docs-Get full LLM documentation (llm-full.txt)
get_llm_docDeveloper docs-Get condensed LLM documentation (llm.txt)