# How to integrate Polar MCP with Atomic Agent

```json
{
  "title": "How to integrate Polar MCP with Atomic Agent",
  "toolkit": "Polar",
  "toolkit_slug": "polar",
  "framework": "Atomic Agent",
  "framework_slug": "atomic-agent",
  "url": "https://composio.dev/toolkits/polar/framework/atomic-agent",
  "markdown_url": "https://composio.dev/toolkits/polar/framework/atomic-agent.md",
  "updated_at": "2026-10-29T05:33:36.522Z"
}
```

## Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Polar.
This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Polar account. See the [Atomic Agent documentation](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions.

## Also integrate Polar with

- [ChatGPT](https://composio.dev/toolkits/polar/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/polar/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/polar/framework/hermes-agent)

## TL;DR

### How Atomic Agent connects to Polar
Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.
Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

## Connect Polar to Atomic Agent

### Connect Polar to Atomic Agent
- Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key.
- In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
- Ask Atomic Agent to do something in Polar. It searches Composio for the right tool.
- On first use, open the sign-in link returned in the chat. Connect your Polar account, then return to Atomic Agent to continue.
### Headless setup
Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

```bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY
```

## What is the Polar MCP server, and what's possible with it?

The Polar MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Polar account. It provides structured and secure access to Polar's merchant-of-record tools, so your agent can create products and checkout sessions, manage customers and subscriptions, issue refunds, and handle customer portal and licensing tasks on your behalf.
- Products and checkout management: Have your agent create products, checkout sessions, checkout links, discounts, and customer orders for your Polar storefront.
- Customer and subscription operations: Let the agent create customers, add customer members, create subscriptions, cancel portal subscriptions, and manage customer payment methods.
- Benefits and license keys: Direct your agent to create benefits such as license keys or file downloads, activate or deactivate license key instances, and manage customer seats.
- Payments, refunds, and disputes: Instruct your agent to create refunds, accept disputes, retry customer payments, or create orders for off-session charges against saved payment methods.
- Account configuration and reporting: Have your agent create organizations, custom fields, files, meters, metric dashboards, and webhook endpoints for your Polar operations.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `POLAR_ACCEPT_DISPUTE` | Accept Dispute | Accept a dispute, permanently conceding the chargeback and settling it as lost. Organization Access Token permissions: `disputes:write`. |
| `POLAR_ACTIVATE_LICENSE_KEY` | Activate License Key | Activate a license key instance. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:write`. |
| `POLAR_ACTIVATE_LICENSE_KEY_PUBLIC` | Activate License Key | Activate a license key instance. This consumes an activation slot until the instance is deactivated. |
| `POLAR_ADD_PORTAL_MEMBER` | Add Portal Member | Add a customer portal member. Requires a member session with the owner or billing manager role; customer sessions are not accepted. Use a unique, controlled member identity and verify the returned member. |
| `POLAR_ADD_PORTAL_PAYMENT_METHOD` | Add Customer Payment Method | Add a payment method to the authenticated customer. |
| `POLAR_ASSIGN_CUSTOMER_SEAT` | Assign Seat | Assign a customer seat. By default this sends an invitation email; set immediate_claim to true to claim the seat without emailing. Verify the target before assigning access. |
| `POLAR_ASSIGN_PORTAL_SEAT` | Assign Portal Seat | Assign a seat using an authenticated customer or member session. By default this sends an invitation email; set immediate_claim to true to claim the seat without emailing. Verify the target before assigning access. |
| `POLAR_CANCEL_PORTAL_SUBSCRIPTION` | Cancel Subscription | Cancel a subscription of the authenticated customer. This changes its cancellation state and can end access according to the subscription terms. |
| `POLAR_CHECK_PORTAL_EMAIL_UPDATE` | Check Email Change Token | Check if an email change verification token is still valid. |
| `POLAR_CLAIM_CUSTOMER_SEAT` | Claim Seat | Claim a customer seat without authentication using a one-time invitation token. This consumes the token, allocates access, and returns a customer session token. |
| `POLAR_COMPLETE_FILE_UPLOAD` | Complete File Upload | Complete a file upload. Organization Access Token permissions: `files:write`. |
| `POLAR_CONFIRM_CHECKOUT_BY_CLIENT_SECRET` | Confirm Checkout Session from Client | Confirm a checkout session by client secret. This may trigger payment or finalize an existing transaction. |
| `POLAR_CONFIRM_PORTAL_PAYMENT_METHOD` | Confirm Customer Payment Method | Confirm a payment method for the authenticated customer. This may trigger payment or finalize an existing transaction. |
| `POLAR_CONFIRM_PORTAL_RETRY_PAYMENT` | Confirm Retry Payment | Confirm a retry payment using a Stripe confirmation token. This may trigger payment or finalize an existing transaction. |
| `POLAR_CREATE_BENEFIT` | Create Benefit | Create a benefit, for example license keys, file downloads or Discord access. Organization Access Token permissions: `benefits:write`. |
| `POLAR_CREATE_CHECKOUT` | Create Checkout Session | Create a checkout session. Organization Access Token permissions: `checkouts:write`. |
| `POLAR_CREATE_CHECKOUT_LINK` | Create Checkout Link | Create a checkout link. Organization Access Token permissions: `checkout_links:write`. |
| `POLAR_CREATE_CUSTOMER` | Create Customer | Create a customer. Organization Access Token permissions: `customers:write`. |
| `POLAR_CREATE_CUSTOMER_MEMBER` | Create Customer Member | Add a member to a customer by UUID. This grants customer access, so verify the identity and intended role first. Organization Access Token permissions: `members:write`. |
| `POLAR_CREATE_CUSTOMER_MEMBER_BY_EXTERNAL_ID` | Create Customer Member by External ID | Add a member to a uniquely identified external customer. This grants customer access, so verify the customer, identity, and intended role first. Organization Access Token permissions: `members:write`. |
| `POLAR_CREATE_CUSTOMER_SESSION` | Create Customer Session | Create a customer session. Organization Access Token permissions: `customer_sessions:write`. |
| `POLAR_CREATE_CUSTOM_FIELD` | Create Custom Field | Create an organization custom field for collecting structured customer or checkout data. |
| `POLAR_CREATE_DISCOUNT` | Create Discount | Create a discount. Organization Access Token permissions: `discounts:write`. |
| `POLAR_CREATE_FILE` | Create File | Create a file. Organization Access Token permissions: `files:write`. |
| `POLAR_CREATE_METER` | Create Meter | Create a meter. Organization Access Token permissions: `meters:write`. |
| `POLAR_CREATE_METRIC_DASHBOARD` | Create Metric Dashboard | Create a user-defined metric dashboard. Organization Access Token permissions: `metrics:write`. |
| `POLAR_CREATE_ORDER` | Create Order | Create a draft order for an off-session charge against a saved payment Organization Access Token permissions: `orders:write`. |
| `POLAR_CREATE_ORGANIZATION` | Create Organization | Create an organization. |
| `POLAR_CREATE_PRODUCT` | Create Product | Create a product. Organization Access Token permissions: `products:write`. |
| `POLAR_CREATE_REFUND` | Create Refund | Create a refund. Organization Access Token permissions: `refunds:write`. |
| `POLAR_CREATE_SUBSCRIPTION` | Create Subscription | Create a subscription programmatically. Organization Access Token permissions: `subscriptions:write`. |
| `POLAR_CREATE_WEBHOOK_ENDPOINT` | Create Webhook Endpoint | Create a webhook endpoint. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `webhooks:write`. |
| `POLAR_DEACTIVATE_LICENSE_KEY` | Deactivate License Key | Deactivate a license key instance. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:write`. |
| `POLAR_DEACTIVATE_LICENSE_KEY_PUBLIC` | Deactivate License Key | Deactivate a license key instance. The identified installation immediately loses its activation. |
| `POLAR_DELETE_BENEFIT` | Delete Benefit | Delete a benefit. This also revokes every associated grant and removes user access. Organization Access Token permissions: `benefits:write`. |
| `POLAR_DELETE_CHECKOUT_LINK` | Delete Checkout Link | Delete a checkout link. Organization Access Token permissions: `checkout_links:write`. |
| `POLAR_DELETE_CUSTOMER` | Delete Customer | Delete a customer. Organization Access Token permissions: `customers:write`. |
| `POLAR_DELETE_CUSTOMER_BY_EXTERNAL_ID` | Delete Customer by External ID | Delete a customer by external ID. Organization Access Token permissions: `customers:write`. |
| `POLAR_DELETE_CUSTOMER_MEMBER` | Delete Customer Member | Permanently remove a member by customer UUID and member UUID. Use only for a disposable or explicitly confirmed member; never remove the sole owner or an unverified shared member. Organization Access Token permissions: `members:write`. |
| `POLAR_DELETE_CUSTOMER_MEMBER_BY_EXTERNAL_ID` | Delete Customer Member by External ID | Permanently remove a member by customer and member external IDs. Verify both targets and use only for a disposable or explicitly confirmed member; never remove the sole owner or an unverified shared member. Organization Access Token permissions: `members:write`. |
| `POLAR_DELETE_CUSTOM_FIELD` | Delete Custom Field | Permanently delete a custom field by ID. Verify the field before deletion. |
| `POLAR_DELETE_DISCOUNT` | Delete Discount | Delete a discount. Organization Access Token permissions: `discounts:write`. |
| `POLAR_DELETE_FILE` | Delete File | Delete a file. Organization Access Token permissions: `files:write`. |
| `POLAR_DELETE_METRIC_DASHBOARD` | Delete Metric Dashboard | Delete a user-defined metric dashboard. Organization Access Token permissions: `metrics:write`. |
| `POLAR_DELETE_PORTAL_PAYMENT_METHOD` | Delete Customer Payment Method | Delete a payment method from the authenticated customer. |
| `POLAR_DELETE_PRODUCT` | Delete Product | Delete a product. Organization Access Token permissions: `products:write`. |
| `POLAR_DELETE_WEBHOOK_ENDPOINT` | Delete Webhook Endpoint | Delete a webhook endpoint. Organization Access Token permissions: `webhooks:write`. |
| `POLAR_EXPORT_CUSTOMERS` | Export Customers | Export customers as a CSV file. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_EXPORT_METRICS` | Export Metrics | Export metrics as a CSV file. Organization Access Token permissions: `metrics:read`. |
| `POLAR_EXPORT_ORDERS` | Export Orders | Export orders as a CSV file. Organization Access Token permissions: `orders:read`. |
| `POLAR_EXPORT_SUBSCRIPTIONS` | Export Subscriptions | Export subscriptions as a CSV file. Organization Access Token permissions: `subscriptions:read` or `subscriptions:write`. |
| `POLAR_FINALIZE_ORDER` | Finalize Order | Finalize a draft order and synchronously attempt an off-session charge. This may trigger payment or finalize an existing transaction. Organization Access Token permissions: `orders:write`. |
| `POLAR_GENERATE_ORDER_INVOICE` | Generate Order Invoice | Trigger generation of an order's invoice. Organization Access Token permissions: `orders:read`. |
| `POLAR_GENERATE_PORTAL_ORDER_INVOICE` | Generate Order Invoice | Trigger generation of an order's invoice. |
| `POLAR_GET_BENEFIT` | Get Benefit | Get a benefit by ID. Organization Access Token permissions: `benefits:read` or `benefits:write`. |
| `POLAR_GET_CHECKOUT` | Get Checkout Session | Get a checkout session by ID. Organization Access Token permissions: `checkouts:read` or `checkouts:write`. |
| `POLAR_GET_CHECKOUT_BY_CLIENT_SECRET` | Get Checkout Session from Client | Get a checkout session by client secret. |
| `POLAR_GET_CHECKOUT_LINK` | Get Checkout Link | Get a checkout link by ID. Organization Access Token permissions: `checkout_links:read` or `checkout_links:write`. |
| `POLAR_GET_CUSTOMER` | Get Customer | Get a customer by ID. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_GET_CUSTOMER_BY_EXTERNAL_ID` | Get Customer by External ID | Get a customer by external ID. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_GET_CUSTOMER_MEMBER` | Get Customer Member | Get a member by customer UUID and member UUID without changing membership. Organization Access Token permissions: `members:read` or `members:write`. |
| `POLAR_GET_CUSTOMER_MEMBER_BY_EXTERNAL_ID` | Get Customer Member by External ID | Get a member by customer and member external IDs without changing membership. The customer external ID must be unique across accessible organizations. Organization Access Token permissions: `members:read` or `members:write`. |
| `POLAR_GET_CUSTOMER_METER` | Get Customer Meter | Get a customer meter by ID. Organization Access Token permissions: `customer_meters:read`. |
| `POLAR_GET_CUSTOMER_SEAT_CLAIM_INFO` | Get Claim Info | Inspect a one-time customer-seat invitation before claiming it, including the customer and subscription context. |
| `POLAR_GET_CUSTOMER_STATE` | Get Customer State | Get a customer state by ID. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_GET_CUSTOMER_STATE_BY_EXTERNAL_ID` | Get Customer State by External ID | Get a customer state by external ID. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_GET_CUSTOM_FIELD` | Get Custom Field | Get one organization custom field and its validation settings by ID. |
| `POLAR_GET_DISCOUNT` | Get Discount | Get a discount by ID. Organization Access Token permissions: `discounts:read` or `discounts:write`. |
| `POLAR_GET_DISPUTE` | Get Dispute | Get a payment dispute by ID. Organization Access Token permissions: `disputes:read` or `disputes:write`. |
| `POLAR_GET_EVENT` | Get Event | Get an event by ID. Organization Access Token permissions: `events:read` or `events:write`. |
| `POLAR_GET_LICENSE_KEY` | Get License Key | Get a license key. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:read` or `license_keys:write`. |
| `POLAR_GET_LICENSE_KEY_ACTIVATION` | Get Activation | Get a license key activation. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:read` or `license_keys:write`. |
| `POLAR_GET_METER` | Get Meter | Get a meter by ID. Organization Access Token permissions: `meters:read` or `meters:write`. |
| `POLAR_GET_METER_QUANTITIES` | Get Meter Quantities | Get quantities of a meter over a time period. Organization Access Token permissions: `meters:read` or `meters:write`. |
| `POLAR_GET_METRIC_DASHBOARD` | Get Metric Dashboard | Get a user-defined metric dashboard by ID. Organization Access Token permissions: `metrics:read`. |
| `POLAR_GET_METRICS` | Get Metrics | Get metrics about your orders and subscriptions. Organization Access Token permissions: `metrics:read`. |
| `POLAR_GET_METRICS_LIMITS` | Get Metrics Limits | Get the interval limits for the metrics endpoint. Organization Access Token permissions: `metrics:read`. |
| `POLAR_GET_ORDER` | Get Order | Get an order by ID. Organization Access Token permissions: `orders:read`. |
| `POLAR_GET_ORDER_INVOICE` | Get Order Invoice | Get an order's invoice data. Organization Access Token permissions: `orders:read`. |
| `POLAR_GET_ORDER_RECEIPT` | Get Order Receipt | Get a presigned URL to download an order's receipt PDF. Organization Access Token permissions: `orders:read`. |
| `POLAR_GET_ORGANIZATION` | Get Organization | Get an organization by ID. Organization Access Token permissions: `organizations:read` or `organizations:write`. |
| `POLAR_GET_PAYMENT` | Get Payment | Get a payment by ID. Organization Access Token permissions: `payments:read`. |
| `POLAR_GET_PORTAL_BENEFIT_GRANT` | Get Benefit Grant | Get a benefit grant by ID for the authenticated customer. |
| `POLAR_GET_PORTAL_CUSTOMER` | Get Customer | Get authenticated customer. |
| `POLAR_GET_PORTAL_LICENSE_KEY` | Get License Key | Get a license key. |
| `POLAR_GET_PORTAL_METER` | Get Customer Meter | Get a meter by ID for the authenticated customer. |
| `POLAR_GET_PORTAL_ORDER` | Get Order | Get an order by ID for the authenticated customer. |
| `POLAR_GET_PORTAL_ORDER_INVOICE` | Get Order Invoice | Get an order's invoice data. |
| `POLAR_GET_PORTAL_ORDER_PAYMENT_STATUS` | Get Order Payment Status | Get the current payment status for an order. |
| `POLAR_GET_PORTAL_ORDER_RECEIPT` | Get Order Receipt | Get a presigned URL to download an order's receipt PDF. |
| `POLAR_GET_PORTAL_ORGANIZATION_PUBLIC` | Get Organization | Get a customer portal's organization by slug. |
| `POLAR_GET_PORTAL_SUBSCRIPTION` | Get Subscription | Get a subscription for the authenticated customer. |
| `POLAR_GET_PORTAL_USER` | Get Authenticated Portal User | Get information about the currently authenticated portal user. |
| `POLAR_GET_PORTAL_WALLET` | Get Portal Wallet | Get a wallet by ID using an authenticated customer or member session. |
| `POLAR_GET_PRODUCT` | Get Product | Get a product by ID. Organization Access Token permissions: `products:read` or `products:write`. |
| `POLAR_GET_SUBSCRIPTION` | Get Subscription | Get a subscription by ID. Organization Access Token permissions: `subscriptions:read` or `subscriptions:write`. |
| `POLAR_GET_WEBHOOK_ENDPOINT` | Get Webhook Endpoint | Get a webhook endpoint by ID. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `webhooks:read` or `webhooks:write`. |
| `POLAR_INGEST_EVENT` | Ingest Events | Ingest batch of events. Organization Access Token permissions: `events:write`. |
| `POLAR_INTROSPECT_PORTAL_SESSION` | Introspect Customer Session | Introspect the current session and return its information. |
| `POLAR_LIST_BENEFIT_FILES` | List Benefit Files | List the downloadable files for a benefit with their download statistics. Organization Access Token permissions: `benefits:read` or `benefits:write`. |
| `POLAR_LIST_BENEFIT_GRANTS_BY_BENEFIT` | List Benefit Grants | List benefit grants across all benefits accessible to the authenticated subject. Organization Access Token permissions: `benefits:read` or `benefits:write`. |
| `POLAR_LIST_BENEFIT_GRANTS_BY_BENEFIT` | List Benefit Grants | List the individual grants for a benefit. Organization Access Token permissions: `benefits:read` or `benefits:write`. |
| `POLAR_LIST_BENEFITS` | List Benefits | List benefits. Organization Access Token permissions: `benefits:read` or `benefits:write`. |
| `POLAR_LIST_CHECKOUT_LINKS` | List Checkout Links | List checkout links. Organization Access Token permissions: `checkout_links:read` or `checkout_links:write`. |
| `POLAR_LIST_CHECKOUTS` | List Checkout Sessions | List checkout sessions. Organization Access Token permissions: `checkouts:read` or `checkouts:write`. |
| `POLAR_LIST_CUSTOMER_MEMBERS` | List Customer Members | List members of a customer by UUID without changing membership. Organization Access Token permissions: `members:read` or `members:write`. |
| `POLAR_LIST_CUSTOMER_MEMBERS_BY_EXTERNAL_ID` | List Customer Members by External ID | List members of a uniquely identified external customer without changing membership. Organization Access Token permissions: `members:read` or `members:write`. |
| `POLAR_LIST_CUSTOMER_METERS` | List Customer Meters | List customer meters. Organization Access Token permissions: `customer_meters:read`. |
| `POLAR_LIST_CUSTOMER_PAYMENT_METHODS` | List Customer Payment Methods | Get saved payment methods of a customer. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_LIST_CUSTOMER_PAYMENT_METHODS_BY_EXTERNAL_ID` | List Customer Payment Methods by External ID | Get saved payment methods of a customer by external ID. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_LIST_CUSTOMERS` | List Customers | List customers. Organization Access Token permissions: `customers:read` or `customers:write`. |
| `POLAR_LIST_CUSTOMER_SEATS` | List Seats | List seats assigned from organization subscriptions, including invitation and claim state. |
| `POLAR_LIST_CUSTOM_FIELDS` | List Custom Fields | List custom data fields configured for an organization and their validation settings. |
| `POLAR_LIST_DISCOUNTS` | List Discounts | List discounts. Organization Access Token permissions: `discounts:read` or `discounts:write`. |
| `POLAR_LIST_DISPUTES` | List Disputes | List payment disputes. Organization Access Token permissions: `disputes:read` or `disputes:write`. |
| `POLAR_LIST_EVENT_NAMES` | List Event Names | List event names. Organization Access Token permissions: `events:read` or `events:write`. |
| `POLAR_LIST_EVENTS` | List Events | List events. Organization Access Token permissions: `events:read` or `events:write`. |
| `POLAR_LIST_EVENT_TYPES` | List Event Types | List event types with usage statistics. Organization Access Token permissions: `events:read` or `events:write`. |
| `POLAR_LIST_FILES` | List Files | List files. Organization Access Token permissions: `files:read` or `files:write`. |
| `POLAR_LIST_LICENSE_KEYS` | List License Keys | Get license keys connected to the given organization & filters. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:read` or `license_keys:write`. |
| `POLAR_LIST_METERS` | List Meters | List meters. Organization Access Token permissions: `meters:read` or `meters:write`. |
| `POLAR_LIST_METRIC_DASHBOARDS` | List Metric Dashboards | List user-defined metric dashboards. Organization Access Token permissions: `metrics:read`. |
| `POLAR_LIST_ORDERS` | List Orders | List orders. Organization Access Token permissions: `orders:read`. |
| `POLAR_LIST_ORGANIZATIONS` | List Organizations | List organizations. Organization Access Token permissions: `organizations:read` or `organizations:write`. |
| `POLAR_LIST_PAYMENTS` | List Payments | List payments. Organization Access Token permissions: `payments:read`. |
| `POLAR_LIST_BENEFIT_GRANTS_BY_BENEFIT` | List Benefit Grants | List benefits grants of the authenticated customer. |
| `POLAR_LIST_PORTAL_CLAIMED_SUBSCRIPTIONS` | List Portal Claimed Subscriptions | List subscriptions claimed through seats by the authenticated customer or member session. |
| `POLAR_LIST_PORTAL_DOWNLOADABLES` | List Downloadables | List files the authenticated customer can download through granted benefits, optionally filtered by benefit. |
| `POLAR_LIST_PORTAL_LICENSE_KEYS` | List License Keys | List license keys issued to the authenticated customer, with optional organization and benefit filters. |
| `POLAR_LIST_PORTAL_MEMBERS` | List Portal Members | List customer portal members. Requires a member session with the owner or billing manager role; customer sessions are not accepted. |
| `POLAR_LIST_PORTAL_METERS` | List Meters | List meters of the authenticated customer. |
| `POLAR_LIST_PORTAL_ORDERS` | List Orders | List orders of the authenticated customer. |
| `POLAR_LIST_PORTAL_PAYMENT_METHODS` | List Customer Payment Methods | Get saved payment methods of the authenticated customer. |
| `POLAR_LIST_PORTAL_SEATS` | List Portal Seats | List seats for a subscription or order available to the authenticated customer or member session. |
| `POLAR_LIST_PORTAL_SUBSCRIPTIONS` | List Subscriptions | List subscriptions of the authenticated customer. |
| `POLAR_LIST_PORTAL_WALLETS` | List Portal Wallets | List wallets available to the authenticated customer or member session. |
| `POLAR_LIST_PRODUCTS` | List Products | List products. Organization Access Token permissions: `products:read` or `products:write`. |
| `POLAR_LIST_REFUNDS` | List Refunds | List refunds. Organization Access Token permissions: `refunds:read` or `refunds:write`. |
| `POLAR_LIST_SUBSCRIPTIONS` | List Subscriptions | List subscriptions. Organization Access Token permissions: `subscriptions:read` or `subscriptions:write`. |
| `POLAR_LIST_WEBHOOK_DELIVERIES` | List Webhook Deliveries | List webhook deliveries. Organization Access Token permissions: `webhooks:read` or `webhooks:write`. |
| `POLAR_LIST_WEBHOOK_ENDPOINTS` | List Webhook Endpoints | List webhook endpoints. Organization Access Token permissions: `webhooks:read` or `webhooks:write`. |
| `POLAR_REDELIVER_WEBHOOK_EVENT` | Redeliver Webhook Event | Schedule the re-delivery of a webhook event. This triggers a new external webhook delivery attempt. This causes an external delivery attempt and must not be retried automatically. Organization Access Token permissions: `webhooks:write`. |
| `POLAR_REMOVE_PORTAL_MEMBER` | Remove Portal Member | Permanently remove a customer portal member. Requires a member session with the owner or billing manager role; customer sessions are not accepted. Use only a disposable member; never target the sole owner or a shared production member. |
| `POLAR_REQUEST_PORTAL_EMAIL_UPDATE` | Request Email Change | Request an email change for the authenticated customer. This sends a verification message to the proposed address. |
| `POLAR_RESEND_CUSTOMER_SEAT_INVITATION` | Resend Invitation | Resend the invitation email for an unclaimed customer seat. This triggers an external email delivery and should not be retried automatically. |
| `POLAR_RESEND_PORTAL_SEAT_INVITATION` | Resend Portal Seat Invitation | Resend a pending seat invitation using an authenticated customer or member session. This sends another email; use a controlled deliverable address and avoid repeated calls. |
| `POLAR_RESET_WEBHOOK_SECRET` | Reset Webhook Endpoint Secret | Regenerate a webhook endpoint secret. The request or response contains sensitive credential material; never log or persist it. This irreversibly replaces the existing secret; update dependents immediately. Organization Access Token permissions: `webhooks:write`. |
| `POLAR_REVOKE_CUSTOMER_SEAT` | Revoke Seat | Permanently revoke a customer seat by ID. Verify the seat before removing access. |
| `POLAR_REVOKE_PORTAL_SEAT` | Revoke Portal Seat | Permanently revoke a seat using an authenticated customer or member session. Use only a disposable seat; never target a sole owner or shared production resource. |
| `POLAR_REVOKE_SUBSCRIPTION` | Revoke Subscription | Revoke a subscription, i.e cancel immediately. This irreversibly revokes the subscription immediately. Organization Access Token permissions: `subscriptions:write`. |
| `POLAR_ROTATE_LICENSE_KEY` | Rotate License Key | Rotate a license key. The request or response contains sensitive credential material; never log or persist it. This irreversibly replaces the existing secret; update dependents immediately. Organization Access Token permissions: `license_keys:write`. |
| `POLAR_ROTATE_PORTAL_LICENSE_KEY` | Rotate License Key | Rotate a license key. The existing key is invalidated and cannot be recovered. |
| `POLAR_UPDATE_BENEFIT` | Update Benefit | Update a benefit. Organization Access Token permissions: `benefits:write`. |
| `POLAR_UPDATE_CHECKOUT` | Update Checkout Session | Update a checkout session. Organization Access Token permissions: `checkouts:write`. |
| `POLAR_UPDATE_CHECKOUT_BY_CLIENT_SECRET` | Update Checkout Session from Client | Update a checkout session by client secret. |
| `POLAR_UPDATE_CHECKOUT_LINK` | Update Checkout Link | Update a checkout link. Organization Access Token permissions: `checkout_links:write`. |
| `POLAR_UPDATE_CUSTOMER` | Update Customer | Update a customer. Organization Access Token permissions: `customers:write`. |
| `POLAR_UPDATE_CUSTOMER_BY_EXTERNAL_ID` | Update Customer by External ID | Update a customer by external ID. Organization Access Token permissions: `customers:write`. |
| `POLAR_UPDATE_CUSTOMER_MEMBER` | Update Customer Member | Update a member by customer UUID and member UUID. Role changes can grant billing or ownership privileges, so verify the target and role first. Organization Access Token permissions: `members:write`. |
| `POLAR_UPDATE_CUSTOMER_MEMBER_BY_EXTERNAL_ID` | Update Customer Member by External ID | Update a member by customer and member external IDs. Role changes can grant billing or ownership privileges, so verify both targets and the role first. Organization Access Token permissions: `members:write`. |
| `POLAR_UPDATE_CUSTOM_FIELD` | Update Custom Field | Update an organization custom field's label, validation, or data-collection settings. |
| `POLAR_UPDATE_DISCOUNT` | Update Discount | Update a discount. Organization Access Token permissions: `discounts:write`. |
| `POLAR_UPDATE_EVENT_TYPE` | Update Event Type | Update an event type's label or dynamic label selector. Organization Access Token permissions: `events:write`. |
| `POLAR_UPDATE_FILE` | Update File | Update a file. Organization Access Token permissions: `files:write`. |
| `POLAR_UPDATE_LICENSE_KEY` | Update License Key | Update a license key. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:write`. |
| `POLAR_UPDATE_METER` | Update Meter | Update a meter. Organization Access Token permissions: `meters:write`. |
| `POLAR_UPDATE_METRIC_DASHBOARD` | Update Metric Dashboard | Update a user-defined metric dashboard. Organization Access Token permissions: `metrics:write`. |
| `POLAR_UPDATE_ORDER` | Update Order | Update an order. Organization Access Token permissions: `orders:write`. |
| `POLAR_UPDATE_ORGANIZATION` | Update Organization | Update an organization. Organization Access Token permissions: `organizations:write`. |
| `POLAR_UPDATE_PORTAL_BENEFIT_GRANT` | Update Benefit Grant | Update a benefit grant for the authenticated customer. |
| `POLAR_UPDATE_PORTAL_CUSTOMER` | Update Customer | Update authenticated customer. |
| `POLAR_UPDATE_PORTAL_MEMBER` | Update Portal Member | Update a customer portal member's name or role. Requires a member session with the owner or billing manager role; customer sessions are not accepted. Verify role changes against a disposable member. |
| `POLAR_UPDATE_PORTAL_ORDER` | Update Order | Update an order for the authenticated customer. |
| `POLAR_UPDATE_PORTAL_SUBSCRIPTION` | Update Subscription | Update a subscription of the authenticated customer. |
| `POLAR_UPDATE_PRODUCT` | Update Product | Update a product. Organization Access Token permissions: `products:write`. |
| `POLAR_UPDATE_PRODUCT_BENEFITS` | Update Product Benefits | Update benefits granted by a product. Organization Access Token permissions: `products:write`. |
| `POLAR_UPDATE_SUBSCRIPTION` | Update Subscription | Update a subscription. Organization Access Token permissions: `subscriptions:write`. |
| `POLAR_UPDATE_WEBHOOK_ENDPOINT` | Update Webhook Endpoint | Update a webhook endpoint. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `webhooks:write`. |
| `POLAR_VALIDATE_LICENSE_KEY` | Validate License Key | Validate a license key and optionally increment its usage count. The request or response contains sensitive credential material; never log or persist it. Organization Access Token permissions: `license_keys:write`. |
| `POLAR_VALIDATE_LICENSE_KEY_PUBLIC` | Validate License Key | Validate a license key and optionally increment its usage count. |
| `POLAR_VERIFY_PORTAL_EMAIL_UPDATE` | Verify Email Change | Verify and apply an email change using the token from the verification email. This changes the customer's sign-in email. |

## Supported Triggers

None listed.

## Troubleshooting

### Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

### Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

### Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See [Composio pricing](/pricing) for the current limits that apply to your connection.

## Complete Code

None listed.

## Conclusion

### Use Polar from Atomic Agent
With your account connected, ask Atomic Agent to work with Polar in natural language. You can connect more apps through the same Composio integration as you need them.
Visit the [Atomic Agent website](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo).

## How to build Polar MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/polar/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/polar/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/polar/framework/hermes-agent)

## Related Toolkits

- [Stripe](https://composio.dev/toolkits/stripe) - Stripe is a global online payments platform offering APIs for managing payments, customers, and subscriptions. Trusted by businesses for secure, efficient, and scalable payment processing worldwide.
- [44API](https://composio.dev/toolkits/44api) - 44API is an API service for validating VAT and tax identifiers and returning company details. Use it to verify business tax data and manage account IP whitelists quickly.
- [Addresszen](https://composio.dev/toolkits/addresszen) - Addresszen is a real-time address autocomplete and verification service. It helps capture accurate, deliverable addresses with instant suggestions and validation.
- [Airwallex](https://composio.dev/toolkits/airwallex) - Airwallex is a global financial platform providing business accounts, payments, payouts, FX, and cards. Built to simplify cross-border payments and streamline financial operations for businesses.
- [Aiwyn Tax MCP](https://composio.dev/toolkits/aiwyn_tax_mcp) - Aiwyn Tax MCP is a tax estimation service powered by Aiwyn's federal and state tax engine. It helps teams estimate tax outcomes without building tax calculation logic from scratch.
- [Alpaca](https://composio.dev/toolkits/alpaca) - Alpaca is a stock and crypto trading platform for commission-free trading, real-time market data, and algorithmic strategies. Use it to build brokerage apps, trading bots, and portfolio workflows with market connectivity.
- [Alpha vantage](https://composio.dev/toolkits/alpha_vantage) - Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions.
- [Altoviz](https://composio.dev/toolkits/altoviz) - Altoviz is a cloud-based billing and invoicing platform for businesses. It streamlines online payments, expense tracking, and customizable invoice management.
- [Asin data api](https://composio.dev/toolkits/asin_data_api) - Asin data api gives you detailed, real-time product data from Amazon, including price, rank, and reviews. Perfect for e-commerce pros and data-driven marketers who need instant marketplace insights.
- [Baselinker](https://composio.dev/toolkits/baselinker) - BaseLinker is an all-in-one e-commerce management platform connecting stores, marketplaces, carriers, and more. It streamlines order processing, inventory control, and automates your sales operations.
- [Benzinga](https://composio.dev/toolkits/benzinga) - Benzinga provides real-time financial news and data APIs for market coverage. It helps you track breaking news and actionable market insights instantly.
- [Bestbuy](https://composio.dev/toolkits/bestbuy) - Best Buy is a leading retailer offering APIs for product, store, and recommendation data. Instantly access up-to-date retail insights for smarter shopping and decision-making.
- [bexio](https://composio.dev/toolkits/bexio) - bexio is a Swiss business management platform for accounting, invoicing, contacts, projects, banking, expenses, and payroll. It brings core business operations into one connected workspace.
- [Bigdata.com MCP](https://composio.dev/toolkits/bigdata_com_mcp) - Bigdata.com MCP provides grounded access to financial news, transcripts, filings, and entity intelligence. Ideal for building research workflows and generating timely market insights.
- [Billsby](https://composio.dev/toolkits/billsby) - Billsby is a subscription billing platform for managing customers, subscriptions, invoices, products, plans, usage counters, add-ons, and allowances. It helps SaaS and subscription teams automate billing operations without building complex billing logic from scratch.
- [Bluebarry](https://composio.dev/toolkits/bluebarry) - Bluebarry is a customer data and product-advice platform for shopper identities, profiles, and recommendations. It helps teams analyze customer context and synchronize shopper data for better commerce experiences.
- [Brex](https://composio.dev/toolkits/brex) - Brex provides corporate credit cards and spend management tailored for startups and tech businesses. It helps optimize company cash flow, streamline accounting, and accelerate business growth.
- [Btcpay server](https://composio.dev/toolkits/btcpay_server) - BTCPay Server is a free, open-source, self-hosted Bitcoin payment processor. It lets merchants accept Bitcoin payments directly, cutting out middlemen and boosting privacy.
- [Cashfree](https://composio.dev/toolkits/cashfree_payments_mcp) - Cashfree is a merchant payments platform that handles collection, payouts, subscriptions, settlements, refunds, and identity verification. Simplifies merchant money lifecycle management with unified, API-driven workflows.
- [Cdr platform](https://composio.dev/toolkits/cdr_platform) - Cdr platform is an API for purchasing carbon dioxide removal services. It enables businesses to offset emissions by accessing verified carbon removal projects.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Polar MCP?

With a standalone Polar MCP server, the agents and LLMs can only access a fixed set of Polar tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Polar and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Atomic Agent?

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Polar tools.

### Can I manage the permissions and scopes for Polar while using Tool Router?

Yes, absolutely. You can configure which Polar scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Polar data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)