> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subotiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Subotiz MCP

Subotiz MCP is an open toolset server based on the [Model Context Protocol](https://spec.modelcontextprotocol.io/). 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](https://www.subotiz.com/).

## 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

* sandbox: [https://api.sandbox.subotiz.com/mcp](https://api.sandbox.subotiz.com/mcp)
* prod: [https://api.subotiz.com/mcp](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):

```json theme={null}
{
  "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](/en/api/authentication-1).

***

## 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) |