Commet
  • Pricing
Log InTry out

Getting Started

AI Onboarding

AI Tools

MCP Server

Agent Skills

Commet SkillsBilling Best Practices SkillPricing Models SkillSubscription Patterns Skill
DocumentationKnowledge BaseBuild with AIAPI ReferenceWebhooks

MCP Server

Use the MCP Server to manage billing infrastructure.

What is an MCP Server?

MCP is an open protocol that standardizes how applications provide context to LLMs. Among other benefits, it provides LLMs tools to act on your behalf.

What can Commet's MCP Server do?

Commet's MCP server gives your AI agent native access to the full Commet platform through a single integration. You can manage all aspects of your billing infrastructure using natural language.

  • Organizations — List, create, switch, and get current organization
  • Plans — Create, update, delete, and toggle visibility of plans. Add and remove prices and features
  • Features — Create, update, delete features and seat types
  • Customers — List, search, create, and update customers. View their subscriptions, invoices, and usage
  • Subscriptions — Search subscriptions, view details, invoices, and transactions
  • Invoices — Search invoices, view with line items, get billing summary
  • Usage — View usage summary by feature or by customer
  • Transactions — List recent transactions, view financial summary
  • Addons — Create, update, and archive add-ons linked to features
  • Promo Codes — Toggle promo codes between active and inactive
  • API Keys — Create and delete API keys for SDK integration

As an example, you could use this to create a full billing setup, manage plans and features, inspect customer subscriptions, or review invoices and usage data.

Prerequisites

The MCP endpoint is the same for sandbox and live data:

https://commet.co/mcp

Once connected, pick a sandbox or live organization with the switch-organization tool. Commands run against whichever org is active.

To use it, you'll need to:

  • Create a Commet account
  • Have an MCP-compatible client (Cursor, Claude Code, Claude Desktop, etc.)

No API key is needed. Authentication happens automatically through OAuth when your client connects.

Switch to a sandbox organization when experimenting or setting up billing for the first time. Operations on a live organization affect real customers immediately.

How to use the MCP Server

Choose your preferred client below.

Open the command palette and choose "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "commet": {
      "url": "https://commet.co/mcp"
    }
  }
}
claude mcp add --transport http commet https://commet.co/mcp

Open Claude Desktop settings > "Developer" tab > "Edit Config".

{
  "mcpServers": {
    "commet": {
      "url": "https://commet.co/mcp"
    }
  }
}
codex mcp add commet --url https://commet.co/mcp

The command opens the browser for OAuth authentication. Once complete, verify with:

codex mcp list

Add the following to your VS Code settings.json:

{
  "mcp": {
    "servers": {
      "commet": {
        "type": "http",
        "url": "https://commet.co/mcp"
      }
    }
  }
}

Add the following to ~/.gemini/settings.json:

{
  "mcpServers": {
    "commet": {
      "httpUrl": "https://commet.co/mcp"
    }
  }
}

Add the following to opencode.json:

{
  "mcp": {
    "commet": {
      "type": "remote",
      "url": "https://commet.co/mcp"
    }
  }
}
{
  "mcpServers": {
    "commet": {
      "serverUrl": "https://commet.co/mcp"
    }
  }
}

Available Tools

The MCP server exposes the following tools once connected:

Organizations

ToolDescription
list-organizationsList all organizations you have access to (live and sandbox)
get-current-organizationGet the currently active organization
switch-organizationSwitch to a different organization
create-organizationCreate a new organization

Plans & Features

ToolDescription
list-plansList all plans in the current organization
create-planCreate a new plan
update-planUpdate a plan's name or description
delete-planSoft-delete a plan. Cannot delete a plan that has subscriptions
toggle-plan-visibilityToggle a plan between public and private. Private plans are hidden but existing subscriptions keep access
add-plan-priceAdd a price to a plan
add-plan-featureAdd a feature to a plan
remove-plan-featureRemove a feature from a plan
list-featuresList all features in the current organization
create-featureCreate a new feature
update-featureUpdate a feature's name, description, or unit name
delete-featureSoft-delete a feature. Must be removed from all plans first
create-seat-typeCreate a new seat type
update-seat-typeUpdate a seat type's name or description
delete-seat-typeSoft-delete a seat type. Must be removed from all features first
list-seat-typesList all seat types

Customers

ToolDescription
list-customersList all customers
search-customersSearch customers by name or email
create-customerCreate a new customer
update-customerUpdate a customer's billing email, name, or timezone
get-customerGet customer details with address
get-customer-subscriptionsView a customer's subscriptions
get-customer-invoicesView a customer's invoices
get-customer-usageView a customer's usage data

Subscriptions

ToolDescription
search-subscriptionsSearch subscriptions by name, customer, or plan
get-subscriptionGet full subscription details with balance and pricing
get-subscription-invoicesView invoices for a subscription
get-subscription-transactionsView payment transactions for a subscription

Invoices & Billing

ToolDescription
search-invoicesSearch invoices by number or filter by status
get-invoiceGet invoice with line items
get-invoice-summaryGet billing summary by status

Usage & Transactions

ToolDescription
get-usage-summaryGet usage summary aggregated by feature
list-transactionsList recent transactions with optional status filter
get-transaction-summaryGet financial transaction summary

Addons

ToolDescription
create-addonCreate a new add-on linked to a feature with its own pricing and consumption model
update-addonUpdate an add-on's name, description, or base price
delete-addonArchive (soft-delete) an add-on. Cannot archive with active subscriptions

Promo Codes

ToolDescription
toggle-promo-codeToggle a promo code between active and inactive. Inactive codes cannot be redeemed at checkout

API Keys

ToolDescription
create-api-keyCreate an API key for SDK integration
delete-api-keyPermanently delete an API key. Applications using it will immediately lose access

How is this guide?

AI Onboarding

Everything you need to onboard your AI agent to Commet.

Commet Skills

Give AI agents expert-level billing knowledge with Agent Skills.

On this page

What is an MCP Server?
What can Commet's MCP Server do?
Prerequisites
How to use the MCP Server
Available Tools
Organizations
Plans & Features
Customers
Subscriptions
Invoices & Billing
Usage & Transactions
Addons
Promo Codes
API Keys