Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stellartools.dev/llms.txt

Use this file to discover all available pages before exploring further.

StellarTools exposes a Model Context Protocol (MCP) server so agents in Cursor, Claude Desktop, and other MCP clients can work with your customers, products, checkouts, subscriptions, payments, and refunds. The tools map to the same REST handlers you already use auth, validation, and business logic stay in one place. You need an API key from dashboard.stellartools.dev/api-keys.

​
Endpoint

https://api.stellartools.dev/mcp

​
Authentication

Send your API key on every connection in the x-api-key header. StellarTools resolves the key to your organization and environment before any tool runs. 
x-api-key: sk_test_...
If the key is missing or invalid, tool calls return an error result. Use a testnet key while developing and switch to mainnet when you go live.

​
Connect in Cursor

Add this to your project or user MCP config (.cursor/mcp.json or Cursor Settings → MCP): 
{
  "mcpServers": {
    "stellartools": {
      "url": "https://api.stellartools.dev/mcp",
      "headers": {
        "x-api-key": "sk_test_your_key_here"
      }
    }
  }
}
Replace the key with yours. Restart Cursor or reload MCP servers after saving.

​
Connect in Claude Desktop

In claude_desktop_config.json: 
{
  "mcpServers": {
    "stellartools": {
      "url": "https://api.stellartools.dev/mcp",
      "headers": {
        "x-api-key": "sk_test_your_key_here"
      }
    }
  }
}

​
Available tools

Tool names and inputs mirror the REST API. Arguments are merged into the shape expected by each route (path params, query, and body fields in one object).
ToolDescription
create_customersCreate one or more customers
create_productCreate a product
create_refundCreate a refund
delete_checkoutDelete a checkout (id)
delete_customerDelete a customer (customerId)
delete_productDelete a product (id)
get_balanceStellar account balance for your org wallet
get_checkoutGet a checkout (id)
get_customerGet one customer by ID (customerId)
get_customersList customers for your organization
get_paymentGet one payment (id)
get_paymentsList payments
get_subscriptionsList subscriptions
update_checkoutUpdate a checkout (id + fields)
update_customerUpdate a customer (customerId + fields)
update_productUpdate a product (id + fields)
Successful tool calls return JSON in the MCP text content. For field-level detail on each resource, see the API Reference.