Skip to main content
Supercharge your AI agents with Polar as a Model Context Protocol (MCP) server.

What is MCP?

MCP is a protocol for integrating tools with AI agents. It can greatly enhance the capabilities of your AI agents by providing them with real-time data and context. Polar offers a remote MCP server that you can connect to from most AI clients.

How does it work?

You need a MCP-capable agent environment to use Polar over MCP. A few of them are Claude Desktop and Cursor.

Connecting to Polar MCP

Polar provides two MCP servers:
  • Production: https://mcp.polar.sh/mcp/polar-mcp - Connect to your live Polar organization
  • Sandbox: https://mcp.polar.sh/mcp/polar-sandbox - Connect to the Polar sandbox environment for testing
When you can specify a MCP URL, use one of the URLs above depending on your environment. If you have to specify a command, use:
{
  "mcpServers": {
    "Polar": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.polar.sh/mcp/polar-mcp"]
    }
  }
}
For sandbox:
{
  "mcpServers": {
    "Polar Sandbox": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.polar.sh/mcp/polar-sandbox"]
    }
  }
}

Cursor

In .cursor/mcp.json, add:
{
  "mcpServers": {
    "Polar": {
      "url": "https://mcp.polar.sh/mcp/polar-mcp"
    }
  }
}
For sandbox:
{
  "mcpServers": {
    "Polar Sandbox": {
      "url": "https://mcp.polar.sh/mcp/polar-sandbox"
    }
  }
}

Windsurf

In mcp_config.json, add:
{
  "mcpServers": {
    "Polar": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.polar.sh/mcp/polar-mcp"]
    }
  }
}
For sandbox:
{
  "mcpServers": {
    "Polar Sandbox": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.polar.sh/mcp/polar-sandbox"]
    }
  }
}

Codex

Add the following to your ~/.codex/config.toml:
[features]
rmcp_client = true

[mcp_servers.polar]
type = "http"
url = "https://mcp.polar.sh/mcp/polar-mcp"
Then run:
codex mcp login polar
For sandbox:
[features]
rmcp_client = true

[mcp_servers.polar_sandbox]
type = "http"
url = "https://mcp.polar.sh/mcp/polar-sandbox"
Then run:
codex mcp login polar_sandbox

Claude Code

Run the following command:
claude mcp add --transport http "Polar" "https://mcp.polar.sh/mcp/polar-mcp"
For sandbox:
claude mcp add --transport http "Polar Sandbox" "https://mcp.polar.sh/mcp/polar-sandbox"

ChatGPT

MCP is only available for paid users in beta on ChatGPT web, by enabling Developer Mode. Once Developer Mode is enabled, go to SettingsConnectors and add the MCP server using https://mcp.polar.sh/mcp/polar-mcp. For sandbox, use https://mcp.polar.sh/mcp/polar-sandbox instead.

Claude Desktop

Go to SettingsConnectors and click Add custom connector. Name it “Polar” and add https://mcp.polar.sh/mcp/polar-mcp as the server URL. For sandbox, use https://mcp.polar.sh/mcp/polar-sandbox as the server URL instead. Save, and click Connect to connect to your Polar organization.