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/mcpOnce 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/mcpOpen Claude Desktop settings > "Developer" tab > "Edit Config".
{
"mcpServers": {
"commet": {
"url": "https://commet.co/mcp"
}
}
}codex mcp add commet --url https://commet.co/mcpThe command opens the browser for OAuth authentication. Once complete, verify with:
codex mcp listAdd 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
| Tool | Description |
|---|---|
list-organizations | List all organizations you have access to (live and sandbox) |
get-current-organization | Get the currently active organization |
switch-organization | Switch to a different organization |
create-organization | Create a new organization |
Plans & Features
| Tool | Description |
|---|---|
list-plans | List all plans in the current organization |
create-plan | Create a new plan |
update-plan | Update a plan's name or description |
delete-plan | Soft-delete a plan. Cannot delete a plan that has subscriptions |
toggle-plan-visibility | Toggle a plan between public and private. Private plans are hidden but existing subscriptions keep access |
add-plan-price | Add a price to a plan |
add-plan-feature | Add a feature to a plan |
remove-plan-feature | Remove a feature from a plan |
list-features | List all features in the current organization |
create-feature | Create a new feature |
update-feature | Update a feature's name, description, or unit name |
delete-feature | Soft-delete a feature. Must be removed from all plans first |
create-seat-type | Create a new seat type |
update-seat-type | Update a seat type's name or description |
delete-seat-type | Soft-delete a seat type. Must be removed from all features first |
list-seat-types | List all seat types |
Customers
| Tool | Description |
|---|---|
list-customers | List all customers |
search-customers | Search customers by name or email |
create-customer | Create a new customer |
update-customer | Update a customer's billing email, name, or timezone |
get-customer | Get customer details with address |
get-customer-subscriptions | View a customer's subscriptions |
get-customer-invoices | View a customer's invoices |
get-customer-usage | View a customer's usage data |
Subscriptions
| Tool | Description |
|---|---|
search-subscriptions | Search subscriptions by name, customer, or plan |
get-subscription | Get full subscription details with balance and pricing |
get-subscription-invoices | View invoices for a subscription |
get-subscription-transactions | View payment transactions for a subscription |
Invoices & Billing
| Tool | Description |
|---|---|
search-invoices | Search invoices by number or filter by status |
get-invoice | Get invoice with line items |
get-invoice-summary | Get billing summary by status |
Usage & Transactions
| Tool | Description |
|---|---|
get-usage-summary | Get usage summary aggregated by feature |
list-transactions | List recent transactions with optional status filter |
get-transaction-summary | Get financial transaction summary |
Addons
| Tool | Description |
|---|---|
create-addon | Create a new add-on linked to a feature with its own pricing and consumption model |
update-addon | Update an add-on's name, description, or base price |
delete-addon | Archive (soft-delete) an add-on. Cannot archive with active subscriptions |
Promo Codes
| Tool | Description |
|---|---|
toggle-promo-code | Toggle a promo code between active and inactive. Inactive codes cannot be redeemed at checkout |
API Keys
| Tool | Description |
|---|---|
create-api-key | Create an API key for SDK integration |
delete-api-key | Permanently delete an API key. Applications using it will immediately lose access |
How is this guide?