# Amberflo MCP by usefulapi

> Amberflo MCP by usefulapi is a freemium MCP server for finance and payments. Hosted MCP server to query and manage Amberflo billing data from AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode, CLI
- **Website:** https://usefulapi.io/amberflo/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/amberflo
- **MCP Registry name:** io.usefulapi/amberflo
- **Categories:** finance and payments
- **Listing updated:** 2026-11-18

## About

The README describes a hosted endpoint that lets an AI client read and change Amberflo metering and billing data without a local install. Once connected, a user can look up customers, meters, usage totals, plan history, invoices and prepaid credit orders in plain language.

The server signs in through OAuth, and the login page asks for an Amberflo API key that the server uses to call the Amberflo API on the user's behalf. Of its 18 tools, 11 are read-only, 3 can create customers, assign plans or ingest usage events, and the rest handle usage status, feature requests and subscription management for the server itself.

It suits finance and billing teams who already meter usage in Amberflo and want quick answers about customers or invoices from Claude, ChatGPT, Cursor or another MCP client. The vendor notes it is an independent service, not an official Amberflo product.

## Features

- **Customer and plan lookup:** List or fetch customers and see their latest product plan and plan history.
- **Usage querying:** Get total usage across meters for a period, grouped by customer, or for a single meter.
- **Raw event drill-down:** Read the meter events behind a usage figure to help find odd or duplicate events.
- **Invoice inspection:** List a customer's invoices with payment status and open the current or a past invoice.
- **Guarded write actions:** Create customers, assign pricing plans and ingest usage events, which clients can ask you to confirm.

## Good for

- Check which customers used the most of a product in a given month
- Find out why a meter total looks wrong by reading its raw events
- Review which unpaid invoices a customer has open
- Confirm a customer's current plan and earlier plan assignments
- Create a new customer and attach a pricing plan from an AI chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http amberflo https://amberflo.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://amberflo.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "amberflo": {
      "url": "https://amberflo.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "amberflo": {
      "type": "http",
      "url": "https://amberflo.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "amberflo": {
      "serverUrl": "https://amberflo.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "amberflo": {
      "type": "http",
      "url": "https://amberflo.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `amberflo_list_customers`: List all customers registered in your Amberflo account (id, name, email, traits, enabled). Good first call to discover customer ids. API: GET /customers/.
- `amberflo_get_customer`: Fetch a single customer by its Amberflo customerId. API: GET /customers/?customerId=<id>.
- `amberflo_list_meters`: List all meter definitions in your account (id, meterApiName, label, meterType, aggregation, etc.). Use meterApiName values here as inputs to usage tools. API: GET /meters.
- `amberflo_get_usage`: Query aggregated usage for a single meter over a time range, optionally grouped/filtered. API: POST /usage/.
- `amberflo_get_all_usage`: Get total usage across all meters over a time range, optionally grouped by customer or filtered to one customer. API: GET /usage/all.
- `amberflo_explain_usage`: Explain/drill into the raw meter events behind a meter's usage over a time range — useful to debug why a number looks off. API: POST /usage/explain.
- `amberflo_get_customer_plan`: Get a customer's LATEST assigned product plan (pricing). API: GET /payments/pricing/amberflo/customer-pricing?CustomerId=<id>.
- `amberflo_list_customer_plan_history`: List the full history of product plans assigned to a customer over time. API: GET /payments/pricing/amberflo/customer-pricing/list?CustomerId=<id>.
- `amberflo_list_customer_invoices`: List all invoices for a customer (optionally for a specific product), with payment status. API: GET /payments/billing/customer-product-invoice/all.
- `amberflo_get_customer_invoice`: Get a single customer invoice: the CURRENT open invoice (latest=true, default) or a SPECIFIC past invoice by product_plan_id + year + month + day. API: GET /payments/billing/customer-product-invoice.
- `amberflo_list_prepaid_orders`: List a customer's active prepaid credit orders for a product. API: GET /payments/pricing/amberflo/customer-prepaid/list?CustomerId=<id>&ProductId=<pid>.
- `amberflo_create_customer`: WRITE: create/register a new customer in Amberflo (id + name required; optional email, enabled flag, and traits). Optionally auto-create the customer in Stripe. API: POST /customers/.
- `amberflo_assign_customer_plan`: WRITE: assign/attach a pricing product plan to a customer — this changes what the customer is billed. API: POST /payments/pricing/amberflo/customer-pricing.
- `amberflo_ingest_usage`: WRITE: record/ingest a single usage meter event (writes billable usage data) to the Amberflo ingestion host. API: POST /ingest/ on the ingest base URL.

## FAQ

### Is this an official Amberflo product?

No. The listing states usefulapi is an independent service and is not affiliated with or endorsed by Amberflo.

### How do I connect it?

Add the server URL as a remote MCP server (Streamable HTTP) in your client, add only the URL, then log in with your Amberflo API key on the login page.

### Can the AI change my Amberflo data?

Yes, through three tools that create or change data: creating customers, assigning plans and ingesting usage events. The other 11 data tools are read-only.

### What does it cost?

The Free plan allows 50 tool calls a month. Pro is $9/mo or $90/yr for 10,000 calls, and Pro+ is $39/mo or $390/yr for 100,000 calls.

### Is Amberflo MCP by usefulapi free?

Amberflo MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Amberflo MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http amberflo https://amberflo.usefulapi.io/mcp

### What are the best alternatives to Amberflo MCP by usefulapi?

The closest alternatives to Amberflo MCP by usefulapi are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 14 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/amberflo-mcp-by-usefulapi
