Baremetrics MCP

Ask your revenue data anything

Connect Baremetrics to Claude, Cursor or Codex and get answers about MRR, churn and customers from your Stripe or other billing data, in plain English.

Connect Baremetrics MCP Read the docs

Works with Claude Desktop·Claude Code·Cursor·Codex

claude — baremetrics

You How did MRR change last month, and why?

Agent

MRR grew 3.1% to $48,200. Here's the breakdown:

New customers +$3,410

Upgrades +$1,180

Downgrades −$640

Cancellations −$2,500

Net change +$1,450

Prompts

Ask your agent to…

Copy any prompt, paste it into your AI tool, and get an answer from your live Baremetrics data.

“What's our MRR today, and how has it changed over the last 6 months?”

“Show our retention cohorts for the last 6 months. Which signup month kept customers best?”

“List every customer who churned in the last 30 days, with their plan and MRR.”

“Who are our 10 customers with the highest LTV?”

“Which customers upgraded this quarter, and which plans did they move to?”

“Compare our customer churn rate this quarter to last quarter.”

“Which plan brings in the most revenue, and which is growing fastest?”

“What's our current ARPU and LTV, and how have they trended this year?”

“Summarize our key metrics in 5 bullets I can paste into Slack.”

…and keep following the thread.

Every answer raises the next question. With your metrics inside your AI tool, you can keep digging in the same conversation, without rebuilding a report or switching tabs.

From a top-line number to a real answer in four questions.

claude — baremetrics

You How did MRR change last month?

Agent

MRR grew 3.1%, but revenue churn was up 40% from the month before.

You Which customers churned?

Agent

14 customers, and 9 of them were on the Starter plan.

You How long had those Starter customers been with us?

Agent

Most left within their first 90 days.

You Compare that to the same period last year.

Agent

Early churn on Starter has nearly doubled. Onboarding may be worth a look.

Workflows

Turn one prompt into a report you can send

Go past single questions. These prompts turn your Baremetrics data into the reports you'd otherwise build by hand.

Write your investor update in minutes

Using my Baremetrics data, draft a monthly investor update for [month]. Include MRR, MRR growth, new customers, cancellations and revenue churn. Add 3 highlights and 1 risk worth flagging.

Investor update · September

MRR$48,200

MRR growth+3.1%

New customers37

Cancellations14

Revenue churn5.2%

Find out why customers are leaving

Review every customer who churned in the last [90] days. Group them by plan and tenure, show the MRR lost in each group, and tell me which group I should look at first.

MRR lost by plan

Starter · under 90 days$1,640

Starter · 90–365 days$420

Growth$380

Scale$60

See which plans are pulling their weight

Compare my plans over the last [6] months: customers, MRR, ARPU and churn for each. Rank them and suggest 2 questions I should ask before changing pricing.

MRR by plan · 6 months

Growth · ARPU$164

Scale · ARPU$402

Setup

Connected in under 5 minutes

Adding the Baremetrics MCP server to Claude Code, Cursor or Codex takes one command or a short snippet. All you need is your API key, and it works on a free trial too.

STEP 1

Grab your API key

Find it in Settings → API. It starts with lk_.

STEP 2

Add Baremetrics to your AI tool

Pick your tool and paste the correct snippet.

STEP 3

Start asking

Try a prompt from above.

Run in your terminal

claude mcp add baremetrics https://app.baremetrics.com/mcp \
  --transport http \
  --scope user \
  --header "Authorization: Bearer <BM_API_KEY>"

~/.cursor/mcp.json

{
  "mcpServers": {
    "baremetrics": {
      "url": "https://app.baremetrics.com/mcp",
      "headers": {
        "Authorization": "Bearer <BM_API_KEY>"
      }
    }
  }
}

macOS ~/Library/Application Support/Claude/claude_desktop_config.json · Windows %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "baremetrics": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.baremetrics.com/mcp",
        "--header",
        "Authorization: Bearer <BM_API_KEY>"
      ]
    }
  }
}

~/.codex/config.toml · set BM_API_KEY in your shell

[mcp_servers.baremetrics]
url = "https://app.baremetrics.com/mcp"
bearer_token_env_var = "BM_API_KEY"

Using ChatGPT or Claude in the browser? Web clients aren't supported yet. OAuth support is on the way. Full setup guide →

FAQ

Questions

What is the Baremetrics MCP?

The Baremetrics MCP is a read-only MCP server that connects Baremetrics to AI tools like Claude, Cursor and Codex. Once it's connected, you can ask your AI tool about your MRR, churn, LTV and customers in plain English and get answers from your live Baremetrics data.

What is an MCP server?

An MCP server is a small service that gives an AI tool a safe, structured way to read data from another product. The Model Context Protocol is the shared standard those tools use. The Baremetrics MCP server exposes your Baremetrics metrics over that standard, so your AI tool can answer questions about them without you exporting anything.

What data can AI tools access through the Baremetrics MCP?

The Baremetrics MCP gives AI tools read access to 21 SaaS metrics, including MRR, ARR, ARPU, LTV, revenue churn, user churn, trial conversions and failed charges. It also covers retention cohorts, customers, subscriptions, plans, charges and account events.

Which AI tools work with the Baremetrics MCP?

The Baremetrics MCP works with four desktop AI tools: Claude Desktop, Claude Code, Cursor and Codex. Browser-based tools like ChatGPT and Claude.ai aren't supported yet.

Can I use the Baremetrics MCP with ChatGPT or Claude?

Not yet. The Baremetrics MCP currently works only with desktop AI tools: Claude Desktop, Claude Code, Cursor and Codex. Browser-based tools like ChatGPT and Claude.ai need OAuth, which Baremetrics is working on.

Does the Baremetrics MCP work with Stripe data?

Yes. The Baremetrics MCP works with Stripe data once your Stripe account is connected to Baremetrics. Your AI tool can then answer questions about the MRR, churn, LTV and customer metrics Baremetrics calculates from Stripe. If you have more than one billing source connected, such as Stripe and Braintree, it uses all of them by default, or you can ask about just one.

How do I add the Baremetrics MCP server to Claude Code?

To add the Baremetrics MCP server to Claude Code, run claude mcp add baremetrics https://app.baremetrics.com/mcp --transport http --scope user --header "Authorization: Bearer <BM_API_KEY>" in your terminal. Replace <BM_API_KEY> with your Baremetrics API key, then ask Claude Code a question about your metrics.

How do I add the Baremetrics MCP server to Cursor?

To add the Baremetrics MCP server to Cursor, add a baremetrics entry to ~/.cursor/mcp.json with the URL https://app.baremetrics.com/mcp and an Authorization header containing your Baremetrics API key. The full snippet is in the Baremetrics MCP setup guide.

Where do I find my Baremetrics API key?

Your Baremetrics API key is in Settings → API in your Baremetrics account. Live keys start with lk_. The Baremetrics MCP uses this key to connect your AI tool to your data.

Can I use the Baremetrics MCP on a free trial?

Yes. The Baremetrics MCP works on a Baremetrics free trial, so you can connect an AI tool and test it with your own data before you pay.

Do I need to code to use the Baremetrics MCP?

No. Setting up the Baremetrics MCP takes one command or a short config snippet pasted into your AI tool. After that, you ask questions in plain English.

Can the Baremetrics MCP change my data?

No. The Baremetrics MCP is read-only. AI tools connected to it can read your metrics, customers, subscriptions and charges, but they can't edit, delete or create anything in your Baremetrics account.

How accurate are AI answers from the Baremetrics MCP?

AI answers from the Baremetrics MCP are generally reliable for trends and direction because they come from your live Baremetrics data. AI tools can occasionally misread raw data, so confirm specific figures in Baremetrics before making important decisions.

Stop exporting and start asking

Connect Baremetrics to your AI tool once, and every answer about your revenue is a question away.

Connect Baremetrics MCP Start free trial