Model Context Protocol (MCP)

Use Polar’s remote Model Context Protocol (MCP) server to give AI agents secure access to your Polar organization. Agents can look up data and take actions across your products, customers, subscriptions, orders, benefits, and more.

Polar MCP uses OAuth. When you connect a client, your browser opens so you can sign in and authorize access to your organization. You never need to copy an API key into your agent.

Connect your agent

Use the production server at https://mcp.polar.sh/mcp/polar-mcp for your live organization. While building or testing, use the sandbox server at https://mcp.polar.sh/mcp/polar-sandbox and give it a distinct name such as polar-sandbox. Choose your client and add the appropriate server.

Add the following to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json to make Polar available in every project:

{
  "mcpServers": {
    "polar": {
      "url": "https://mcp.polar.sh/mcp/polar-mcp"
    }
  }
}

Open Cursor’s MCP settings and connect to polar to complete authorization.

Run:

claude mcp add --transport http polar https://mcp.polar.sh/mcp/polar-mcp

Then open /mcp in Claude Code and authenticate polar with OAuth.

In ChatGPT, open Settings → Connectors, enable developer mode if prompted, and add a custom connector with:

Name: Polar
MCP server URL: https://mcp.polar.sh/mcp/polar-mcp

Save the connector, select Connect, and complete authorization in the browser.

Open Settings → Connectors, select Add custom connector, and enter:

Name: Polar
MCP server URL: https://mcp.polar.sh/mcp/polar-mcp

Save the connector, select Connect, and complete authorization in the browser.

Run:

codex mcp add "polar" --url "https://mcp.polar.sh/mcp/polar-mcp"

Complete the OAuth authorization when prompted.

Run:

opencode mcp add polar --url https://mcp.polar.sh/mcp/polar-mcp

Complete the OAuth authorization when prompted.

If your client accepts a remote MCP URL, add:

https://mcp.polar.sh/mcp/polar-mcp

If it only supports local commands, use the mcp-remote bridge:

{
  "mcpServers": {
    "polar": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.polar.sh/mcp/polar-mcp"
      ]
    }
  }
}

How dynamic toolsets work

Polar supports a broad set of operations. Sending every operation and its full input schema to an agent at the start of every conversation would consume context, make tool selection less reliable, and add unnecessary latency. Instead, Polar uses a dynamic toolset with three lightweight meta-tools. Your agent discovers the relevant operation at runtime, loads only the schema it needs, and then executes it.

Tool	What it does
`search_tools`	Searches the Polar operation catalog and returns the tools relevant to the agent’s task.
`describe_tools`	Loads the description and input schema for selected tools before the agent calls them.
`execute_tool`	Runs a selected tool with the supplied arguments and returns the result.

The agent calls search_tools with what it wants to accomplish, such as “find a customer and check their active subscriptions.”

Inspect

The agent calls describe_tools for the best matches to learn their exact inputs and behavior.

Execute

The agent calls execute_tool with the selected tool name and validated arguments.

Available tools

The runtime tools above provide access to the following Polar operations.

Available tools (100)

Tool	Description
List benefit grants	List benefit grants across all benefits accessible to the authenticated subject.
Create benefit	Create a new benefit (entitlement) like license keys, file downloads, or Discord access.
Delete benefit	Delete a benefit. Caution: all associated grants will be revoked and users will lose access.
List benefit files	List the downloadable files for a benefit with their download statistics.
Get benefit	Get a benefit by ID.
List grants for benefit	List the individual grants for a benefit. It’s especially useful to check if a user has been granted a benefit.
List benefits	List all existing benefits.
Update benefit	Update an existing benefit’s configuration.
Create checkout link	Create a checkout link.
Delete checkout link	Delete a checkout link.
Get checkout link	Get a checkout link by ID.
List checkout links	List checkout links.
Update checkout link	Update a checkout link.
Get checkout session	Get a checkout session by ID.
List checkout sessions	List checkout sessions.
Create custom field	Create a custom field.
Delete custom field	Delete a custom field.
Get custom field	Get a custom field by ID.
List custom fields	List custom fields.
Update custom field	Update a custom field.
Get customer meter	Get a customer meter by ID.
List customer meters	List customer meters.
Assign customer seat	Assign a seat for a subscription or order.
Claim customer seat	Claim Seat
Get customer seat claim info	Get claim information for a customer seat invitation.
List customer seats	List seats for a subscription or order.
Resend customer seat invitation	Resend an invitation for a pending customer seat.
Revoke customer seat	Revoke a customer seat.
Create customer	Create a new customer record with email, name, metadata, and optional external_id for reconciliation.
Delete customer	Delete a customer. This action cannot be undone and will immediately: - Cancel any active subscriptions for the customer - Revoke all their benefits - Clear any `external_id` Use it only in the context of deleting a user within your own service. Otherwise, use more granular API endpoints to cancel a specific subscription or revoke certain benefits. Note: The customers information will nonetheless be retained for historic orders and subscriptions. Set `anonymize=true` to also anonymize PII for GDPR compliance.
Delete customer by external ID	Delete a customer by external ID. Immediately cancels any active subscriptions and revokes any active benefits. Set `anonymize=true` to also anonymize PII for GDPR compliance.
Get customer	Get a customer by ID.
Get customer by external ID	Get a customer by external ID.
Get customer state	Get a customer state by ID. The customer state includes information about the customer’s active subscriptions and benefits. It’s the ideal endpoint to use when you need to get a full overview of a customer’s status.
Get customer state by external ID	Get a customer state by external ID. The customer state includes information about the customer’s active subscriptions and benefits. It’s the ideal endpoint to use when you need to get a full overview of a customer’s status.
List customers	List customers.
List customer payment methods	Get saved payment methods of a customer.
List customer payment methods by external ID	Get saved payment methods of a customer by external ID.
Create customer member	Create a new member for a customer. Only B2B customers with the member management feature enabled can add members. The authenticated user or organization must have access to the customer’s organization.
Create customer member by external ID	Create a new member for a customer identified by its external ID.
Delete customer member	Delete a member of a customer.
Delete customer member by external ID	Delete a member by external ID for a customer identified by its external ID.
Get customer member	Get a member of a customer by its ID.
Get customer member by external ID	Get a member by external ID for a customer identified by its external ID.
Update customer member	Update the name, email, or role of a customer member.
Update customer member by external ID	Update a member by external ID for a customer identified by its external ID.
Update customer	Update a customer.
Update customer by external ID	Update a customer by external ID.
Create discount code	Create a new discount code for products or subscriptions.
Delete discount	Delete a discount.
Get discount	Retrieve a specific discount by ID.
List discount codes	List all discount codes and coupons.
Update discount	Update an existing discount’s settings or validity.
List event types	List event types with aggregated statistics.
Update event type	Update an event type’s label.
Get event	Get an event by ID.
List event names	List event names.
Delete file	Delete a file.
List files	List files.
Get license key	Get a license key.
Get license key activation	Get a license key activation.
List license keys	Get license keys connected to the given organization & filters.
Rotate license key	Rotate a license key. Generates a new key string for the same license key record. The previous key string immediately stops validating. Status, usage, limits, expiry, and activations are preserved.
Update license key	Update a license key.
List customer members	List members with optional customer ID filter.
Create meter	Create a new usage meter to track customer consumption for usage-based pricing models.
Get meter	Retrieve a specific meter by ID.
List meters	List all usage meters in your organization for tracking consumption-based billing and analytics.
Update meter	Update an existing meter’s configuration.
Get metrics	Get metrics about your orders and subscriptions. Currency values are output in cents.
Get metrics limits	Get the interval limits for the metrics endpoint.
Generate order invoice	Trigger generation of an order’s invoice.
Get order	Get an order by ID.
Get order invoice	Get an order’s invoice data.
List orders	List orders.
Get order receipt	Get a presigned URL to download an order’s receipt PDF.
Update order	Update an order.
Get organization	Get an organization by ID.
List organizations	List organizations.
Get payment	Get a payment by ID.
List payments	List payments.
Create product	Create a new product with pricing and benefits (entitlements).
Get product	Retrieve a specific product by ID.
List products	List all products in your organization.
Update product	Update an existing product’s details, pricing, or settings.
Update product benefits	Update which benefits are granted when a product is purchased.
Create refund	Create a refund.
List refunds	List refunds.
Get subscription details	Get a subscription by ID.
List subscriptions	List active subscriptions.
Revoke subscription	Revoke a subscription, i.e cancel immediately.
Update subscription	Update a subscription.
Create webhook endpoint	Create a webhook endpoint.
Delete webhook endpoint	Delete a webhook endpoint.
Get webhook endpoint	Get a webhook endpoint by ID.
List webhook deliveries	List webhook deliveries. Deliveries are all the attempts to deliver a webhook event to an endpoint.
List webhook endpoints	List webhook endpoints.
Redeliver webhook event	Schedule the re-delivery of a webhook event.
Reset webhook endpoint secret	Regenerate a webhook endpoint secret.
Update webhook endpoint	Update a webhook endpoint.

Bootup

Features

Integrate

Merchant of Record (MoR)

Model Context Protocol (MCP)

Connect your agent

How dynamic toolsets work

Available tools

​Connect your agent

​How dynamic toolsets work

​Available tools

Connect your agent

How dynamic toolsets work

Available tools