Amberflo MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.36.5Updated Nov 8, 2026

Query and manage Amberflo metering & billing: customers, meters, usage, plans, invoices, prepaid.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinance Data & Analytics Business & Commerce

Server details

Identifier: io.usefulapi/amberflo
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to usefulapi.io, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Famberflo.svg)](https://sourceweft.com/mcp/io.usefulapi%2Famberflo?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Query and manage Amberflo metering and billing from an assistant: customers, meters, usage, plans, invoices and prepaid credit orders.

What you can do: List and fetch customers, and create new ones (optionally also in Stripe)
List meter definitions and query aggregated usage per meter or across all meters, with grouping and filters
Drill into raw meter events behind a usage figure to explain why a number looks off
Read a customer's latest plan, full plan history, and assign a new pricing plan
List and fetch customer invoices with payment status, and list active prepaid credit orders
Ingest a single usage meter event, and check or manage the server's own call quota and subscription
When to use it: Useful when you run usage-based billing on Amberflo and want to ask questions in plain language about usage, plans, invoices and prepaid credits, or make small changes such as registering a customer, assigning a plan or recording a usage event.
Requirements: Remote hosted endpoint; no local install. Connect with the server URL only and sign in through OAuth, pasting your Amberflo API key on first connect. The key is validated and stored per user. A free tier allows 50 tool calls per month; paid plans are available.

Before you install

Three tools write data: creating a customer (which can also create it in Stripe), assigning a plan (which changes what the customer is billed) and ingesting usage events (billable data). Confirm before running them. Your Amberflo API key is pasted into the hosted service and stored there, and your account data passes through a third party. Paid plans are billed through Stripe Checkout links; cancellation runs to the end of the paid period with no refund for the current period.

Installation

In SourceWeft

Open Amberflo MCP by usefulapi in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Famberflo/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Amberflo MCP by usefulapi

Read customers, meters, usage, plans and invoices — and create customers, assign plans or ingest usage events — from Claude, Cursor, or any MCP client. Hosted, no local install — connect with your Amberflo API key.

Live endpoint: https://amberflo.usefulapi.io/mcp · Homepage: https://usefulapi.io/amberflo

Connect

Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://amberflo.usefulapi.io/mcp.
Claude Code: claude mcp add --transport http amberflo https://amberflo.usefulapi.io/mcp, then run /mcp to log in.
VS Code: Add to VS Code.
Cursor and other clients: add the URL as a remote MCP server:

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Amberflo credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/amberflo/

On first connect you'll paste your Amberflo API key. It's validated, stored per-user, and scoped to you.

Tools

Tool	Type	What it does
`amberflo_list_customers`	read	List customers
`amberflo_get_customer`	read	Get a customer
`amberflo_list_meters`	read	List meters
`amberflo_get_usage`	read	Query usage for a meter
`amberflo_get_all_usage`	read	Get all usage
`amberflo_explain_usage`	read	Explain usage
`amberflo_get_customer_plan`	read	Get customer plan
`amberflo_list_customer_plan_history`	read	List customer plan history
`amberflo_list_customer_invoices`	read	List customer invoices
`amberflo_get_customer_invoice`	read	Get customer invoice
`amberflo_list_prepaid_orders`	read	List prepaid orders
`amberflo_create_customer`	write	Create customer
`amberflo_assign_customer_plan`	write	Assign customer plan
`amberflo_ingest_usage`	write	Ingest usage event
`amberflo_usage_status`	meta	Usage status (free-tier meter)
`amberflo_request_feature`	meta	Request a missing feature
`amberflo_upgrade`	meta	Upgrade to Pro or Pro+
`amberflo_cancel_subscription`	meta	Cancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with amberflo_upgrade (it returns a Stripe Checkout link). Cancel any time with amberflo_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running amberflo_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/amberflo/README.md at commit 4046075

Tools

amberflo_list_customers

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

Takes no parameters.

amberflo_get_customer

Get a customer

Fetch a single customer by its Amberflo customerId. API: GET /customers/?customerId=<id>.

Parameterscustomer_idrequired

amberflo_list_meters

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.

Takes no parameters.

amberflo_get_usage

Query usage for a meter

Query aggregated usage for a single meter over a time range, optionally grouped/filtered. API: POST /usage/.

Parametersfiltergroup_bytake_limitaggregationrequiredmeter_api_namerequiredtake_is_ascendingend_time_in_secondsstart_time_in_secondsrequiredtime_grouping_intervalrequired

amberflo_get_all_usage

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.

Parametersend_time_in_secondsgroup_by_customer_idfilter_by_customer_idstart_time_in_secondsrequiredtime_grouping_intervalrequired

amberflo_explain_usage

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.

Parametersfiltergroup_bytake_limitaggregationmeter_api_namerequiredend_time_in_secondsstart_time_in_secondsrequired

amberflo_get_customer_plan

Get customer plan

Get a customer's LATEST assigned product plan (pricing). API: GET /payments/pricing/amberflo/customer-pricing?CustomerId=<id>.

Parameterscustomer_idrequired

amberflo_list_customer_plan_history

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

Parameterscustomer_idrequired

amberflo_list_customer_invoices

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.

Parametersfrom_cacheproduct_idcustomer_idrequiredwith_payment_status

amberflo_get_customer_invoice

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.

Parametersdayyearmonthlatestfrom_cacheproduct_idcustomer_idrequiredproduct_plan_idwith_payment_status

amberflo_list_prepaid_orders

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

Parametersproduct_idcustomer_idrequired

amberflo_create_customer

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

Parameterstraitsenabledcustomer_idrequiredcustomer_namerequiredcustomer_emailcreate_in_stripe

amberflo_assign_customer_plan

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.

Parametersproduct_idcustomer_idrequiredproduct_plan_idrequiredend_time_in_secondsstart_time_in_seconds

amberflo_ingest_usage

Ingest usage event

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.

Parametersunique_iddimensionscustomer_idrequiredmeter_valuerequiredmeter_api_namerequiredmeter_time_in_millisrequired

Version history

v1.36.5LatestNov 8, 2026
v1.36.4Nov 7, 2026
v1.35.3Nov 5, 2026
v1.35.2Nov 5, 2026
v1.35.1Nov 4, 2026
v1.35.0Nov 3, 2026
v1.34.1Nov 3, 2026
v1.33.0Nov 1, 2026
v1.31.0Oct 31, 2026
v1.30.0Oct 31, 2026
v1.29.2Oct 30, 2026
v1.29.0Oct 30, 2026
v1.24.0Oct 26, 2026
v1.21.3Oct 25, 2026
v1.21.0Oct 25, 2026
v1.20.0Oct 24, 2026
v1.17.0Oct 23, 2026
v1.16.4Oct 22, 2026
v1.16.3Oct 21, 2026
v1.11.1Oct 9, 2026
v1.10.0Oct 9, 2026
v1.0.1Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Communication & Collaboration15 toolsNov 8, 2026

Plan	Price	Limit
Free	$0	50 tool calls / month
Pro	$9/mo or $90/yr (2 months free)	Unlimited*