Polar MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Polar MCP or direct API to manage products, create checkouts, track subscriptions, and review orders through natural language.

Polar logoPolar
Oauth2Api KeyBearer TokenNo Auth

Polar is a merchant-of-record platform for digital products, payments, subscriptions, and customer management. It simplifies global selling by handling checkout, billing, taxes, and customer portals.

181 Tools

Try Polar now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Polar
Try asking
TOOLS

Supported Tools

Every Polar action and event your agent gets out of the box.

Accept Dispute

Accept a dispute, permanently conceding the chargeback and settling it as lost.

Activate License Key

Activate a license key instance.

Activate License Key

Activate a license key instance.

Add Portal Member

Add a customer portal member.

Add Customer Payment Method

Add a payment method to the authenticated customer.

Assign Seat

Assign a customer seat.

Assign Portal Seat

Assign a seat using an authenticated customer or member session.

Cancel Subscription

Cancel a subscription of the authenticated customer.

Check Email Change Token

Check if an email change verification token is still valid.

Claim Seat

Claim a customer seat without authentication using a one-time invitation token.

Complete File Upload

Complete a file upload.

Confirm Checkout Session from Client

Confirm a checkout session by client secret.

Confirm Customer Payment Method

Confirm a payment method for the authenticated customer.

Confirm Retry Payment

Confirm a retry payment using a Stripe confirmation token.

Create Benefit

Create a benefit, for example license keys, file downloads or Discord access.

Create Checkout Session

Create a checkout session.

Create Checkout Link

Create a checkout link.

Create Customer

Create a customer.

Create Customer Member

Add a member to a customer by UUID.

Create Customer Member by External ID

Add a member to a uniquely identified external customer.

Create Customer Session

Create a customer session.

Create Custom Field

Create an organization custom field for collecting structured customer or checkout data.

Create Discount

Create a discount.

Create File

Create a file.

Create Meter

Create a meter.

Create Metric Dashboard

Create a user-defined metric dashboard.

Create Order

Create a draft order for an off-session charge against a saved payment Organization Access Token permissions: `orders:write`.

Create Organization

Create an organization.

Create Product

Create a product.

Create Refund

Create a refund.

Create Subscription

Create a subscription programmatically.

Create Webhook Endpoint

Create a webhook endpoint.

Deactivate License Key

Deactivate a license key instance.

Deactivate License Key

Deactivate a license key instance.

Delete Benefit

Delete a benefit.

Delete Checkout Link

Delete a checkout link.

Delete Customer

Delete a customer.

Delete Customer by External ID

Delete a customer by external ID.

Delete Customer Member

Permanently remove a member by customer UUID and member UUID.

Delete Customer Member by External ID

Permanently remove a member by customer and member external IDs.

Delete Custom Field

Permanently delete a custom field by ID.

Delete Discount

Delete a discount.

Delete File

Delete a file.

Delete Metric Dashboard

Delete a user-defined metric dashboard.

Delete Customer Payment Method

Delete a payment method from the authenticated customer.

Delete Product

Delete a product.

Delete Webhook Endpoint

Delete a webhook endpoint.

Export Customers

Export customers as a CSV file.

Export Metrics

Export metrics as a CSV file.

Export Orders

Export orders as a CSV file.

Export Subscriptions

Export subscriptions as a CSV file.

Finalize Order

Finalize a draft order and synchronously attempt an off-session charge.

Generate Order Invoice

Trigger generation of an order's invoice.

Generate Order Invoice

Trigger generation of an order's invoice.

Get Benefit

Get a benefit by ID.

Get Checkout Session

Get a checkout session by ID.

Get Checkout Session from Client

Get a checkout session by client secret.

Get Checkout Link

Get a checkout link by ID.

Get Customer

Get a customer by ID.

Get Customer by External ID

Get a customer by external ID.

Get Customer Member

Get a member by customer UUID and member UUID without changing membership.

Get Customer Member by External ID

Get a member by customer and member external IDs without changing membership.

Get Customer Meter

Get a customer meter by ID.

Get Claim Info

Inspect a one-time customer-seat invitation before claiming it, including the customer and subscription context.

Get Customer State

Get a customer state by ID.

Get Customer State by External ID

Get a customer state by external ID.

Get Custom Field

Get one organization custom field and its validation settings by ID.

Get Discount

Get a discount by ID.

Get Dispute

Get a payment dispute by ID.

Get Event

Get an event by ID.

Get License Key

Get a license key.

Get Activation

Get a license key activation.

Get Meter

Get a meter by ID.

Get Meter Quantities

Get quantities of a meter over a time period.

Get Metric Dashboard

Get a user-defined metric dashboard by ID.

Get Metrics

Get metrics about your orders and subscriptions.

Get Metrics Limits

Get the interval limits for the metrics endpoint.

Get Order

Get an order by ID.

Get Order Invoice

Get an order's invoice data.

Get Order Receipt

Get a presigned URL to download an order's receipt PDF.

Get Organization

Get an organization by ID.

Get Payment

Get a payment by ID.

Get Benefit Grant

Get a benefit grant by ID for the authenticated customer.

Get Customer

Get authenticated customer.

Get License Key

Get a license key.

Get Customer Meter

Get a meter by ID for the authenticated customer.

Get Order

Get an order by ID for the authenticated customer.

Get Order Invoice

Get an order's invoice data.

Get Order Payment Status

Get the current payment status for an order.

Get Order Receipt

Get a presigned URL to download an order's receipt PDF.

Get Organization

Get a customer portal's organization by slug.

Get Subscription

Get a subscription for the authenticated customer.

Get Authenticated Portal User

Get information about the currently authenticated portal user.

Get Portal Wallet

Get a wallet by ID using an authenticated customer or member session.

Get Product

Get a product by ID.

Get Subscription

Get a subscription by ID.

Get Webhook Endpoint

Get a webhook endpoint by ID.

Ingest Events

Ingest batch of events.

Introspect Customer Session

Introspect the current session and return its information.

List Benefit Files

List the downloadable files for a benefit with their download statistics.

List Benefit Grants

List benefit grants across all benefits accessible to the authenticated subject.

List Benefit Grants

List the individual grants for a benefit.

List Benefits

List benefits.

List Checkout Links

List checkout links.

List Checkout Sessions

List checkout sessions.

List Customer Members

List members of a customer by UUID without changing membership.

List Customer Members by External ID

List members of a uniquely identified external customer without changing membership.

List Customer Meters

List customer meters.

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.

List Customers

List customers.

List Seats

List seats assigned from organization subscriptions, including invitation and claim state.

List Custom Fields

List custom data fields configured for an organization and their validation settings.

List Discounts

List discounts.

List Disputes

List payment disputes.

List Event Names

List event names.

List Events

List events.

List Event Types

List event types with usage statistics.

List Files

List files.

List License Keys

Get license keys connected to the given organization & filters.

List Meters

List meters.

List Metric Dashboards

List user-defined metric dashboards.

List Orders

List orders.

List Organizations

List organizations.

List Payments

List payments.

List Benefit Grants

List benefits grants of the authenticated customer.

List Portal Claimed Subscriptions

List subscriptions claimed through seats by the authenticated customer or member session.

List Downloadables

List files the authenticated customer can download through granted benefits, optionally filtered by benefit.

List License Keys

List license keys issued to the authenticated customer, with optional organization and benefit filters.

List Portal Members

List customer portal members.

List Meters

List meters of the authenticated customer.

List Orders

List orders of the authenticated customer.

List Customer Payment Methods

Get saved payment methods of the authenticated customer.

List Portal Seats

List seats for a subscription or order available to the authenticated customer or member session.

List Subscriptions

List subscriptions of the authenticated customer.

List Portal Wallets

List wallets available to the authenticated customer or member session.

List Products

List products.

List Refunds

List refunds.

List Subscriptions

List subscriptions.

List Webhook Deliveries

List webhook deliveries.

List Webhook Endpoints

List webhook endpoints.

Redeliver Webhook Event

Schedule the re-delivery of a webhook event.

Remove Portal Member

Permanently remove a customer portal member.

Request Email Change

Request an email change for the authenticated customer.

Resend Invitation

Resend the invitation email for an unclaimed customer seat.

Resend Portal Seat Invitation

Resend a pending seat invitation using an authenticated customer or member session.

Reset Webhook Endpoint Secret

Regenerate a webhook endpoint secret.

Revoke Seat

Permanently revoke a customer seat by ID.

Revoke Portal Seat

Permanently revoke a seat using an authenticated customer or member session.

Revoke Subscription

Revoke a subscription, i.

Rotate License Key

Rotate a license key.

Rotate License Key

Rotate a license key.

Update Benefit

Update a benefit.

Update Checkout Session

Update a checkout session.

Update Checkout Session from Client

Update a checkout session by client secret.

Update Checkout Link

Update a checkout link.

Update Customer

Update a customer.

Update Customer by External ID

Update a customer by external ID.

Update Customer Member

Update a member by customer UUID and member UUID.

Update Customer Member by External ID

Update a member by customer and member external IDs.

Update Custom Field

Update an organization custom field's label, validation, or data-collection settings.

Update Discount

Update a discount.

Update Event Type

Update an event type's label or dynamic label selector.

Update File

Update a file.

Update License Key

Update a license key.

Update Meter

Update a meter.

Update Metric Dashboard

Update a user-defined metric dashboard.

Update Order

Update an order.

Update Organization

Update an organization.

Update Benefit Grant

Update a benefit grant for the authenticated customer.

Update Customer

Update authenticated customer.

Update Portal Member

Update a customer portal member's name or role.

Update Order

Update an order for the authenticated customer.

Update Subscription

Update a subscription of the authenticated customer.

Update Product

Update a product.

Update Product Benefits

Update benefits granted by a product.

Update Subscription

Update a subscription.

Update Webhook Endpoint

Update a webhook endpoint.

Validate License Key

Validate a license key and optionally increment its usage count.

Validate License Key

Validate a license key and optionally increment its usage count.

Verify Email Change

Verify and apply an email change using the token from the verification email.

SETUP GUIDE

Connect Polar MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["polar"],
  mcp: true,
});
Create a session scoped to Polar and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all products in my Polar account",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Polar request
SETUP GUIDE

Connect Polar API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["polar"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Polar
3

Run Polar tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all products in my Polar account" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Polar tool calls through the session, and print the final answer

Why Use Composio?

AI Native Polar Integration

  • Supports both Polar MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Polar data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Polar access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Polar
  • Scoped, least privilege access to Polar resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Polar requires connections to go through your own OAuth app. You register it once with Polar, add its client ID and secret in the Composio dashboard, and from then on everyone connects by signing in to Polar as usual. Composio handles the rest of the flow and the token refresh.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Polar connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a Polar account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Polar as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Polar lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Polar administrator may need to approve the app first, and you can revoke the access inside Polar whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Polar connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Polar tokens automatically, so day to day you do nothing. If you revoke access inside Polar, or Polar invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal Polar use. Paid plans add higher limits and team features. Your Polar plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Polar accounts).

With Composio, you connect Polar once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Polar.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Polar tool your agent needs.Free to start.

Start building