How to integrate Baremetrics MCP with Atomic Agent

Connect Atomic Agent to Baremetrics MCP. Show monthly recurring revenue trends, find customers likely to churn, and more using natural language, with authentication handled for you.

Baremetrics logoBaremetrics
Api Key

Baremetrics is a subscription analytics platform for recurring-revenue businesses. It helps teams track MRR, churn, customers, and revenue trends in one place.

8 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Baremetrics.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Baremetrics account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Baremetrics with

How Atomic Agent connects to Baremetrics

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Baremetrics to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Baremetrics. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Baremetrics account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Baremetrics MCP server, and what's possible with it?

The Baremetrics MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Baremetrics account. It provides structured and secure access to your subscription metrics, revenue data, customer insights, and account details, so your agent can analyze performance, compare trends, review cohorts, inspect recurring revenue records, and identify connected data sources on your behalf.

  • Business metric summaries: Have your agent review daily MRR, revenue, and customer counts across any inclusive date range.
  • Metric trends and comparisons: Let the agent track a selected metric over time and compare its performance with the prior period.
  • Customer and plan breakdowns: Direct your agent to explain how individual customers or plans contributed to a metric during a chosen period.
  • Cohort analysis: Instruct your agent to compare customer retention and revenue behavior across signup cohorts.
  • Recurring revenue records: Have your agent inspect customers, plans, subscriptions, charges, and refunds, review account details, or identify connected payment and Baremetrics data sources.

Use Baremetrics from Atomic Agent

With your account connected, ask Atomic Agent to work with Baremetrics in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Baremetrics action and event your agent gets out of the box.

Get Account

Return the connected Baremetrics account identity, company, default currency, and calculation range.

Get Cohorts

Return Baremetrics cohort analysis for comparing customer retention and revenue behavior across signup cohorts.

Get Metric Breakdown

Return daily values for one Baremetrics metric broken down by contributing customers or plans over an inclusive date range.

Get Metric Summary

Return wide daily Baremetrics business metrics for an inclusive date range, potentially including MRR, revenue, and customer counts.

Get Metric Trend

Return the daily time series for one Baremetrics metric over an inclusive date range, with prior-period comparison data when available.

Get Recurring Revenue Resource

Get one customer, plan, subscription, charge, or refund by its OID within a Baremetrics source.

List Recurring Revenue Resources

List one page of customers, plans, subscriptions, charges, or refunds from a Baremetrics source, using only filters valid for the selected resource type.

List Sources

List one page of payment and Baremetrics API sources in the connected account and return source IDs required by source-scoped resource tools; use next_cursor to fetch later pages.

FAQ

Frequently asked questions

Start with Baremetrics.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Baremetrics tool your agent needs.Free to start.

Start building