MCP Server

The AgentaOS MCP server lets any Model Context Protocol client (Claude Desktop, Cursor, or Windsurf) create checkouts, read your customers and subscriptions, and send receipts on your behalf. Use it when you want your agent to run the store directly, instead of calling the API or CLI by hand.

Setup

Add the server to your client’s config with a gateway key from app.agentaos.ai → Settings → Developers → API Keys:

{
  "mcpServers": {
    "agenta": {
      "command": "npx",
      "args": ["-y", "agentaos"],
      "env": {
        "AGENTAOS_GATEWAY_KEY": "sk_test_your-gateway-key"
      }
    }
  }
}

Test keys (sk_test_) only ever see test data, so your agent can build and break things safely. The same config works for Cursor and Windsurf.

Tools

Tool	What it does
`agenta_pay_create_checkout`	Create a checkout and get a shareable `checkoutUrl`.
`agenta_pay_get_checkout`	Check whether a payment completed.
`agenta_pay_list_checkouts`	List checkouts by status (`open`, `completed`, `expired`, `cancelled`).
`agenta_pay_list_subscriptions`	List subscriptions: status, amount, interval, and subscriber.
`agenta_pay_cancel_subscription`	Cancel a subscription, at period end or immediately.
`agenta_pay_list_customers`	Everyone who paid you: email, name, and country.
`agenta_pay_send_receipt`	Re-send the receipt email for a paid invoice.

Next steps

Run your store from an agent

The full walkthrough: a coding agent with the CLI, or a chat agent with MCP.

TypeScript SDK

The same operations as typed methods in @agentaos/pay.

CLI

Run AgentaOS from your terminal with agenta.

Quickstart

Create a product and take your first payment.

Getting Started

Build with AI agents

Sell

Merchant of Record

Webhooks

For customers

Experimental

Setup

Tools

Next steps

Run your store from an agent

TypeScript SDK

CLI

Quickstart

​Setup

​Tools

​Next steps

Run your store from an agent

TypeScript SDK

CLI

Quickstart

Setup

Tools

Next steps