---
title: "Baremetrics integration for LuumenAI"
url: "https://www.luumen.ai/integrations/baremetrics/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Baremetrics integration for LuumenAI

Read subscription metrics, cohorts, and customer revenue records from Baremetrics

## What LuumenAI can do with Baremetrics

LuumenAI connects to Baremetrics with an API token and exposes 8 tools (8 read-only). Every tool is read-only, so it can answer questions from Baremetrics but cannot change anything in it.

## Key facts

- Authentication: API token
- Tools available: 8 tools (8 read-only)
- Plan: available on all plans
- Category: Databases & data platforms

## About Baremetrics with LuumenAI

Ask about revenue the same way you ask about infrastructure. Luumen connects to Baremetrics with an API key and reads it for context: BAREMETRICS_GET_METRIC_SUMMARY for daily MRR and customer counts, BAREMETRICS_GET_METRIC_TREND for one metric against the prior period, BAREMETRICS_GET_COHORTS for retention by signup cohort. Answers come back in the terminal. This integration is read-only.

## Example tools

Read-only (8 in total):

- `BAREMETRICS_GET_ACCOUNT` — Return the connected Baremetrics account identity, company, default currency, and calculation range.
- `BAREMETRICS_GET_COHORTS` — Return Baremetrics cohort analysis for comparing customer retention and revenue behavior across signup cohorts.
- `BAREMETRICS_GET_METRIC_BREAKDOWN` — Return daily values for one Baremetrics metric broken down by contributing customers or plans over an inclusive date range.
- `BAREMETRICS_GET_METRIC_SUMMARY` — Return wide daily Baremetrics business metrics for an inclusive date range, including MRR, revenue, and customer counts in each daily row.
- `BAREMETRICS_GET_METRIC_TREND` — Return the daily time series and prior-period comparison for one Baremetrics metric over an inclusive date range.
- `BAREMETRICS_GET_RECURRING_REVENUE_RESOURCE` — Get one customer, plan, subscription, charge, or refund by its OID within a Baremetrics source.
- `BAREMETRICS_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.
- `BAREMETRICS_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.

## Frequently asked questions

### How does LuumenAI connect to Baremetrics?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Baremetrics on its own?

No. Every one of the 8 tools is read-only, so LuumenAI can answer questions from Baremetrics but cannot change anything in it.

### Is there an audit trail?

Every call to Baremetrics is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/baremetrics/