MCP Server

MCP (Model Context Protocol) servers enable AI assistants like Claude to interact directly with the Measure API. With an MCP server, you can manage customers, subscriptions, invoices, and billing operations through natural language conversations with your AI assistant.

Official MCP Server

The Measure MCP server lets you interact with the Measure API through any MCP-compatible AI client (Claude Code, Cursor, etc.) using natural language. Under the hood it proxies your requests to the same Measure REST API, so all existing permissions and rate limits apply.

Prerequisites

• An active Measure account
• An MCP-compatible client (see Supported Clients)

Supported Clients

Claude.ai

Step 1 — Add Measure as a custom connector

In Claude Desktop or Claude.ai, navigate to Connectors. Click button to add new connector

Enter a Name (e.g. Measure) and Remote MCP server URL: https://mcp.getmeasure.com/mcp

Step 2 — Connect

Click Measure to open its detail panel, then click Connect. This launches the Measure authorization flow in your browser.

Step 3 — Authorize access

Select the Measure organization you want to connect, then click Allow to grant Claude access to your account data. You’ll be redirected back to Claude.ai when done.

Step 4 — Configure tool permissions (optional)

Once connected you’ll see a “Connected to Measure” confirmation and a list of available tools for Claude to use. You can control how Claude uses each tool with the permission toggle:

Setting	Behavior
Always allow	Claude uses the tool automatically
Ask every time	Claude asks before running the tool
Never	The tool is disabled

---

Claude Code

Step 1 — Run the following command in your terminal

claude mcp add --transport http Measure https://mcp.getmeasure.com/mcp

Step 2 — Authenticate

Run the following command in your terminal to view mcp servers

claude /mcp

Select authenticate on the Measure MCP. This launches the Measure authorization flow in your browser.

Step 3 — Authorize access

Select the Measure organization you want to connect, then click Allow to grant Claude access to your account data. You’ll be redirected back to Claude Code when done.

---

ChatGPT

Step 1 — Add Measure as a new plugin

In ChatGPT, navigate to Plugins. Click button to add new plugin

Enter a Name (e.g. Measure) and Connection server URL: https://mcp.getmeasure.com/mcp

Step 2 — Authenticate

Click Sign in with Measure MCP. This launches the Measure authorization flow in your browser.

Step 3 — Authorize access

Select the Measure organization you want to connect, then click Allow to grant ChatGPT access to your account data. You’ll be redirected back to ChatGPT when done.

---

Cursor

Step 1 — Add Measure as a new MCP Server

In Cursor, navigate to Customize. Click button to add MCP Server

Add the following to the mcp.json file

{
  "mcpServers": {
      "Measure": {
        "type": "http",
        "url": "https://mcp.getmeasure.com/mcp",
        "tools": [
          "*"
        ]
      }
  }
}

Step 2 — Authenticate

Click Authenticate on the MCP Server

Step 3 — Authorize access

Select the Measure organization you want to connect, then click Allow to grant Cursor access to your account data. You’ll be redirected back to Cursor when done.

---

Other Ways To Connect - Avoiding OAuth

Any client that supports the MCP Streamable HTTP transport can connect using:

• Endpoint: https://mcp.getmeasure.com/mcp
• MEASURE_API_TOKEN header: your Measure API key
• MEASURE_COMPANY_ID header: your Measure company ID

---

Example prompts

Once connected, you can ask Claude things like:

• “Show me all overdue invoices from this month”
• “Find all active subscriptions for Acme Corp”
• “Which customers have the highest MRR?”
• “List contracts expiring in the next 90 days”

Troubleshooting

Measure doesn’t appear in my connector list

On Claude Team or Enterprise accounts, your Claude admin may need to enable third-party connectors. Ask them to enable the Measure connector for your organization.

Authorization failed or redirected incorrectly

Make sure you’re logged into the correct Measure account in your browser before clicking Connect, and that you have permission to authorize third-party integrations in that Measure organization.

---

Giving your AI assistant context

For best results, load the Measure data model reference into your AI assistant’s context before starting a session. It explains how BillableItems, ProductPricings, BundlePricings, Subscriptions, and Customers relate to each other - which helps the assistant form correct queries and avoid common mistakes.

In Claude Code, you can do this with:

fetch https://docs.getmeasure.com/pages/guides/ai-context

Or add it to your project’s CLAUDE.md:

For Measure API context, see: https://docs.getmeasure.com/pages/guides/ai-context

Available Tools

Read-Only Tools

Tool	Description
find_billable_items	Search billable items by name, external name, or state
find_billable_metrics	Search billable metrics by name, item, or state
find_bundles	Search bundles by name or state
find_contracts	Search contracts by customer, status, type, etc.
find_credit_logs	Search credit logs by customer, invoice, action type, etc.
find_credits	Search credits by customer, status, type, currency, etc.
find_customers	Search customers by name, email, MRR, ARR, tags, etc.
find_entitlements	Search entitlements by name, key, or type
find_invoices	Search invoices by customer, status, date range, amount, etc.
find_objects	Search billable objects by customer or item
find_one-time_charges	Search one-time charges by customer, state, or type
find_payment_transactions	Search payment transactions by customer, invoice, status, etc.
find_product_pricing	Search product pricing by name, currency, type, tags, etc.
find_products	Search products by name, state, or tags
find_subscriptions	Search subscriptions by customer, status, MRR, dates, etc.
get_bundle	Retrieve a bundle by ID
get_contract	Retrieve a contract by ID
get_credit	Retrieve a credit by ID
get_customer	Retrieve a customer by ID or external identifier
get_entitlement	Retrieve an entitlement by ID
get_invoice	Retrieve an invoice by UUID
get_invoice_link	Generate an authenticated link to an invoice
get_payment_methods	Get all payment methods for a customer
get_product	Retrieve a product by ID or external identifier
get_product_pricing	Retrieve product pricing by ID or external identifier
get_subscription	Retrieve a subscription by ID or external identifier
get_subscription_usage	Retrieve the subscription usage by ID for a specific metric
get_subscription_usage_for_current_period	Retrieve the usage for the current period of the subscription for a specific billable item
next_invoice	Preview the upcoming invoice for a subscription (supports change/cancel simulation)

Write Tools

Write tools make real changes to your data. Always review what Claude intends to do before confirming, and be especially careful with bulk operations.

Tool	Description
cancel_subscription	Cancel a subscription by ID with the provided cancellation options
change_subscription	Change a subscription by ID with the provided plan details
create_credit	Create a credit with given parameters
create_one-time_charges	Create one-time charges with given parameters
extend_trial_end_date	Update the end of the trial for the subscription
finalize_draft_invoice	Finalize a draft invoice by UUID
generate_invoice_pdf	Generate the invoice as a PDF file
generate_next_invoice	Generate the next invoice for the subscription immediately (asynchronous)
mark_invoice_as_paid	Mark an invoice as paid by UUID
revoke_credit	Revoke a credit by ID
start_managing_customer	Start managing a customer in Measure that was previously managed externally
undo_cancel_subscription	Undo an upcoming cancellation on a subscription (does not revive an already cancelled subscription)
update_customer	Update a customer by ID or external identifier
void_invoice	Void an invoice by UUID

Building your own MCP server

In the meantime, you can build a custom MCP server using our OpenAPI specification. The OpenAPI spec provides a complete definition of all Measure API endpoints, making it straightforward to generate an MCP server that works with any AI assistant that supports the Model Context Protocol.

Options for building

There are several approaches you can take to build an MCP server for Measure:

1. Generate with AI assistants

You can use Claude or other AI assistants to automatically generate an MCP server from the Measure OpenAPI specification. Simply provide the specification and ask the AI assistant to create an MCP server implementation in your preferred language.

2. Use MCP SDKs

The Anthropic MCP SDK provides tools and libraries for building MCP servers in TypeScript and Python. You can use these SDKs to create a custom server that wraps the Measure API.

3. Use OpenAPI-to-MCP conversion tools

Several community tools can automatically convert OpenAPI specifications into MCP servers, allowing you to generate a working server with minimal effort.

Setting up your MCP server

To build and configure your own MCP server:

1. Download the Measure OpenAPI specification
2. Create an API token from the Measure dashboard under Developers > API Token
3. Use your preferred method to generate the MCP server from the OpenAPI specification
4. Configure the server with your API token for authentication

Your API token should be kept secret and secure. Anyone with access to your token will be able to access Measure resources on your behalf.

Once your MCP server is configured and running, you can connect it to AI assistants like Claude to interact with Measure through natural language. You’ll be able to perform operations like creating customers, managing subscriptions, generating invoices, processing payments, and more.

Important considerations for bulk operations

Exercise caution with bulk write operations. When using an MCP server with AI assistants, it’s easy to execute bulk operations through natural language commands. However, certain actions (such as canceling multiple subscriptions, deleting customers, or applying changes to large sets of records) can be irreversible and may have significant business impact.

We recommend:

• Always review bulk operations before confirming execution
• Test bulk operations with a small subset of data first
• Be explicit about which customers or subscriptions should be affected
• Consider the downstream effects of bulk changes (e.g., invoice generation, payment processing)
• Maintain backups or records of data before performing bulk modifications

Some operations that require extra care include:

• Bulk subscription cancellations: Canceling multiple subscriptions at once will immediately stop billing for those customers
• Bulk pricing changes: Changing pricing for multiple subscriptions simultaneously will affect future invoices
• Bulk refunds: Processing refunds in bulk will immediately credit customer accounts and impact your revenue
• Bulk status changes: Changing subscription or customer status in bulk can affect access to your services

Always confirm the scope and impact of bulk operations before proceeding. When in doubt, perform operations one at a time or on a small test set first.

What you can do with an MCP server

With a Measure MCP server connected to your AI assistant, you can perform operations such as:

• Create and manage customers
• Set up and modify subscriptions
• Generate and send one-off invoices
• Process payments and refunds
• Manage products, pricing, and plans
• Handle credits, discounts, and promotions

The MCP server provides a conversational interface to the full Measure API, allowing you to manage your billing operations through natural language interactions.