Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getmeasure.com/llms.txt

Use this file to discover all available pages before exploring further.

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 - Beta

As of Apr 9 2026, the official MCP server supports read-only tools. Create/Update tools are currently in development and will be released soon. If you want to be able to modify data, we recommend using your own MCP server based on our public APIs
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
  • A Measure API key - generate one from Settings → API Keys in the Measure dashboard. Note: Anyone access with access to the API token will be able to perform all actions via the Public APIs or MCP tools.
  • Your company ID - found in Settings → API Keys in the Measure dashboard
  • An MCP-compatible client (see Supported Clients)

​
Connection Details

PropertyValue
Server URLhttps://mcp.getmeasure.com/mcp
TransportStreamable HTTP
MEASURE_API_TOKEN headerYour Measure API key
MEASURE_COMPANY_ID headerYour Measure company ID

​
Supported Clients

​
Claude Code

Run the following command in your terminal: 
claude mcp add --transport http measure https://mcp.getmeasure.com/mcp \
  --header "MEASURE_API_TOKEN:<your-api-key>" \
  --header "MEASURE_COMPANY_ID:<your-company-id>"
The server will be available in all Claude Code sessions immediately.

​
Cursor

  1. Open Cursor Settings → MCP.
  2. Click Add new global MCP server and paste:
{
  "measure": {
    "type": "http",
    "url": "https://mcp.getmeasure.com/mcp",
    "headers": {
      "MEASURE_API_TOKEN": "<your-api-key>",
      "MEASURE_COMPANY_ID": "<your-company-id>"
    }
  }
}
  1. Save and reload the window.

​
Other MCP Clients

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

​
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

As of Apr 9 2026, the official MCP server supports read-only tools. Create/Update tools are currently in development and will be released soon. If you want to be able to modify data, we would recomment using your own MCP server based on our public APIs
ToolDescription
find_billable_itemsSearch billable items by name, external name, or state
find_billable_metricsSearch billable metrics by name, item, or state
find_bundlesSearch bundles by name or state
find_contractsSearch contracts by customer, status, type, etc.
find_credit_logsSearch credit logs by customer, invoice, action type, etc.
find_creditsSearch credits by customer, status, type, currency, etc.
find_customersSearch customers by name, email, MRR, ARR, tags, etc.
find_entitlementsSearch entitlements by name, key, or type
find_invoicesSearch invoices by customer, status, date range, amount, etc.
find_objectsSearch billable objects by customer or item
find_one-time_chargesSearch one-time charges by customer, state, or type
find_payment_transactionsSearch payment transactions by customer, invoice, status, etc.
find_product_pricingSearch product pricing by name, currency, type, tags, etc.
find_productsSearch products by name, state, or tags
find_subscriptionsSearch subscriptions by customer, status, MRR, dates, etc.
get_bundleRetrieve a bundle by ID
get_contractRetrieve a contract by ID
get_creditRetrieve a credit by ID
get_customerRetrieve a customer by ID or external identifier
get_entitlementRetrieve an entitlement by ID
get_invoiceRetrieve an invoice by UUID
get_invoice_linkGenerate an authenticated link to an invoice
get_payment_methodsGet all payment methods for a customer
get_productRetrieve a product by ID or external identifier
get_product_pricingRetrieve product pricing by ID or external identifier
get_subscriptionRetrieve a subscription by ID or external identifier
next_invoicePreview the upcoming invoice for a subscription (supports change/cancel simulation)

​
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.