Model Context Protocol (MCP)

Connect your AI assistant to Pelcro's Core API through the Model Context Protocol (MCP). Manage customers, subscriptions, invoices, 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 feature is currently in beta and subject to change. 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/

Environments

Tools

All tools require a site_id parameter. List tools support page, per_page, and sort (prefix - for descending). You can include site_id naturally in your prompts (e.g. "List customers on site 14") or the AI will ask.

Health check

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

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