HomeProduct DocsAPI ReferenceChangelog
RecurlyAPI GuidesRecurly.jsWebhooksAPI ReferenceSupportBook demo
Product Docs

Compass public MCP server

Connect Claude, Cursor, or any Model Context Protocol tool to Recurly's documentation and API knowledge through the public Compass MCP server.

Recurly Compass MCP connects your AI development tools directly to Recurly's documentation and API knowledge. Point Claude, Cursor, or any Model Context Protocol (MCP)-compatible tool at a single server URL, authenticate once, and start asking questions or generating Recurly code — all without leaving the workflow you already use.
Early access only — available on all Recurly subscription plans at general release

Prerequisites

  • Early access users must have permissions within a site that has the MCP feature flag enabled

Definition

Recurly Compass MCP is a public MCP server that lets AI agents — such as Claude Desktop or Cursor — work directly with Recurly's tools and APIs, without complex setup. It uses streamable HTTP connections to expose Recurly's agents to any compatible AI orchestration tool, so you can bring Recurly's documentation and API knowledge into the development workflow you already use.

Key benefits

No complex setup Connect with a single command or config snippet over streamable HTTP. Nothing to install, no server to run.
Recurly knowledge in your workflow Surface Recurly's documentation and API guidance directly inside Claude, Cursor, or any compatible AI tool.
Two agents, one server The Knowledge Agent answers documentation questions; the Coding Agent supplies code examples and parameter references. Configure either or both.

Key details

Point any compatible AI tool at the Compass MCP server URL:

https://mcp.recurly.com/mcp
TipLog in to Recurly before connecting — the OAuth flow authenticates automatically. Tokens expire after 30 days, so you'll reconnect periodically.

Available agents

AgentDescriptionAccess
Knowledge AgentSearches Recurly's documentation knowledge base to answer questions and surface relevant contentPublic
Coding AgentProvides code examples, parameter references, library guidance, and explanations to help you get code running fasterPublic
NoteYou can configure both agents at once. See the combined Cursor configuration below.

Integrating with Claude

Both agents use the same command in Claude:

claude mcp add --transport http Recurly https://mcp.recurly.com/mcp

Integrating with Cursor

1

Open Cursor settings

Navigate to Settings.

2

Add a new MCP server

Select New MCP Server.

3

Add your configuration

Add the relevant configuration below to your MCP configuration file.

Knowledge Agent only

{
  "mcpServers": {
    "Recurly Compass MCP": {
      "url": "https://mcp.recurly.com/mcp",
      "autoApprove": [
        "docs_search"
      ]
    }
  }
}

Coding Agent only

{
  "mcpServers": {
    "Recurly Compass MCP": {
      "url": "https://mcp.recurly.com/mcp",
      "autoApprove": [
        "api_reference_search"
      ]
    }
  }
}

Both agents

{
  "mcpServers": {
    "Recurly Compass MCP": {
      "url": "https://mcp.recurly.com/mcp",
      "autoApprove": [
        "docs_search",
        "api_reference_search"
      ]
    }
  }
}

Did this page help you?