Model Context Protocol (MCP)

Connect your AI assistant to Pelcro's Core API through the Model Context Protocol (MCP). Manage customers, subscriptions, invoices, addresses, and more directly from your AI tools.

Authentication uses OAuth 2.0 — when you connect, you log into Pelcro, select which account to grant access to, and authorize the app. The token is scoped to a single account.

🚧

This MCP server is under active development. Tool names, parameters, and behavior may change between releases without prior notice. MCP clients should always fetch the latest tool definitions from the server at the start of each session — do not cache or hardcode tool schemas. If you have feedback or want to see more tools, email us at [email protected].

Installation

Claude Code

claude mcp add --transport http pelcro https://mcp.pelcro.com/

Start a new session with claude, type /mcp, select the server, and click Authenticate.

Cursor

Add to your project's .cursor/mcp.json:

{
  "mcpServers": {
    "pelcro": {
      "url": "https://mcp.pelcro.com/"
    }
  }
}

VS Code

Add a pelcro entry to your workspace's .vscode/mcp.json file. See the VS Code MCP documentation for more details on configuring MCP servers.

{
  "servers": {
    "pelcro": {
      "type": "http",
      "url": "https://mcp.pelcro.com/"
    }
  }
}

Windsurf

Add to ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "pelcro": {
      "url": "https://mcp.pelcro.com/"
    }
  }
}

ChatGPT

ChatGPT supports remote MCP servers for Pro, Plus, Business, Enterprise, and Education accounts. To connect Pelcro, create a custom connector in Settings > Apps & Connectors with the server URL https://mcp.pelcro.com/ and select OAuth as the authentication method. See the OpenAI developer mode guide for detailed setup steps.

Other MCP clients

Any client that supports remote MCP servers over Streamable HTTP can connect to https://mcp.pelcro.com/. The server handles OAuth discovery automatically via RFC 9728.

Authorize your account

After installing, your MCP client will open a browser window to complete authentication:

1. Log into your Pelcro account
2. Select which account to grant access to
3. Click Authorize
4. Return to your AI tool — the tools are now available

The token grants full read and write access to the selected account's Core API endpoints.

Manage your connection

Multi-account access

Each MCP server entry is scoped to one account. To access multiple accounts, add multiple entries with different names:

claude mcp add --transport http pelcro-acme https://mcp.pelcro.com/
claude mcp add --transport http pelcro-other https://mcp.pelcro.com/

Each entry triggers its own OAuth flow where you pick a different account on the consent screen.

Re-authenticate

If your token expires or you want to switch accounts, remove the server and re-add it:

claude mcp remove pelcro
claude mcp add --transport http pelcro https://mcp.pelcro.com/

Refreshing tools

MCP clients cache the list of available tools when they first connect. If new tools are added to the server, start a new session or reconnect the MCP server to pick them up.

Environments

Tools

Most tools require a site_id parameter. If you don't know your site ID, use get_account first to discover your available sites. List tools support page and limit for pagination.

Response size

Tool responses are capped at 25,000 characters to protect AI context windows. If a response is truncated, use a smaller limit value or add filters to narrow your results.

Error handling

API errors (400, 401, 404, 500, etc.) are returned as tool results with isError: true, not as protocol-level failures. This allows the AI to reason about the error and retry with different parameters.

Health check

curl https://mcp.pelcro.com/health

{"status": "ok", "version": "1.2.1", "environment": "prd"}