MCP Server

The PagAmerican MCP Server exposes the Data API as native tools for AI agents compatible with the Model Context Protocol. Once connected, you can ask Claude, Cursor, or any MCP client to pull your sales in natural language — no code required.

It’s a remote server — nothing to install. Authentication uses the same clientId + apiKey as the REST API, sent as the X-Client-ID and X-Api-Key headers, and the tools automatically return only the data that belongs to you (your tenant scope is enforced server-side).

Prerequisites

A credential pair (clientId + apiKey) provided by the PagAmerican team, with the analytics.read scope — see Authentication
An MCP-compatible client (Claude Desktop, Cursor, Claude Code, …)

Configuration

The server lives at https://external-api-service.pagamerican.app/mcp (Streamable HTTP transport).

Claude Desktop
Cursor
Claude Code (CLI)

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "pagamerican": {
      "url": "https://external-api-service.pagamerican.app/mcp",
      "headers": {
        "X-Client-ID": "YOUR_CLIENT_ID",
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Restart Claude Desktop. The purchases_list and orders_list tools appear in the tool picker.

Older Claude Desktop versions don’t support remote servers directly. In that case, bridge it with mcp-remote: set "command": "npx" with

"args": ["-y", "mcp-remote", "https://external-api-service.pagamerican.app/mcp", "--header", "X-Client-ID:YOUR_CLIENT_ID", "--header", "X-Api-Key:YOUR_API_KEY"]

Edit ~/.cursor/mcp.json (or Settings → MCP → Add server):

{
  "mcpServers": {
    "pagamerican": {
      "url": "https://external-api-service.pagamerican.app/mcp",
      "headers": {
        "X-Client-ID": "YOUR_CLIENT_ID",
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

claude mcp add --transport http pagamerican \
  https://external-api-service.pagamerican.app/mcp \
  --header "X-Client-ID: YOUR_CLIENT_ID" \
  --header "X-Api-Key: YOUR_API_KEY"

Treat X-Api-Key like a password. Don’t commit these config files to a public repository or share them in screenshots.

Available tools

Tool	Maps to	Description
`purchases_list`	`GET /api/v1/purchases`	Lists your purchases for a date range
`orders_list`	`GET /api/v1/orders`	Lists your completed orders — one item per purchase inside each order

Both tools take from and to (YYYY-MM-DD; to is exclusive, max 90 days from from) and an optional limit (1–5000, default 1000).

orders_list is available for creator credentials only — with affiliate keys the tool isn’t listed. Affiliates get the same data through purchases_list.

Example prompts

Once connected, try:

“List my sales between April 1 and May 1, 2026.”
“How much revenue did I make last week? Use the purchases tool.”
“Show my top 10 most recent purchases and their payment methods.”
“Which orders were completed in July? Use the orders tool.”

Troubleshooting

401 — Missing or invalid credentials

Make sure both X-Client-ID and X-Api-Key headers are set with your exact clientId and apiKey. If the key was revoked or regenerated, update your config and restart the client.

403 — Insufficient scope

Your credentials must have the analytics.read scope. Contact the PagAmerican team if your key is missing it.

The tool doesn't show up

Fully restart the AI client after editing the config (a reload isn’t always enough). Confirm the JSON is valid and the url has no typos. On older Claude Desktop, use the mcp-remote bridge shown above.

Date range error

to is exclusive and the window can’t exceed 90 days. To get April, ask for from=2026-04-01 to to=2026-05-01.

Authentication

How to obtain your clientId and apiKey.

API Reference

The same data over plain REST, with a “Try it” playground.

Get started

Events

Prerequisites

Configuration

Available tools

Example prompts

Troubleshooting

Authentication

API Reference

​Prerequisites

​Configuration

​Available tools

​Example prompts

​Troubleshooting

Authentication

API Reference

Prerequisites

Configuration

Available tools

Example prompts

Troubleshooting