Skip to main content
Glama

Amberflo MCP by usefulapi

by io.usefulapi
OverviewDiscussionsAdmin

Server Details

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

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
80.6% over 55 days
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
Repository
m190/usefulapi-mcp
GitHub Stars
0

TDQS

A3.8/5.0

Scored across 14 tools

Disambiguation5/5

Each tool targets a distinct action and resource (e.g., create_customer vs list_customers, get_customer_plan vs list_customer_plan_history). No two tools overlap in purpose; descriptions clearly differentiate them.

Naming Consistency5/5

All tools follow the consistent pattern amberflo_verb_noun with snake_case. Verbs like create, get, list, assign, explain, ingest are used uniformly, and nouns consistently represent the resource (customer, usage, meters, etc.).

Tool Count5/5

14 tools is well-scoped for a billing/metering server, covering customer management, plan assignment, invoices, usage ingestion/querying, and meter discovery. Each tool serves a clear purpose without excess.

Completeness4/5

The tool set covers essential CRUD and lifecycle operations for customers, plans, invoices, and usage. Minor gaps exist (e.g., no update or delete customer, no unassign plan), but the core workflows are fully supported.

Available Tools

14 tools
amberflo_assign_customer_planAssign customer plan
Destructive
Inspect

WRITE: assign/attach a pricing product plan to a customer — this changes what the customer is billed. API: POST /payments/pricing/amberflo/customer-pricing.

ParametersJSON Schema
NameRequiredDescriptionDefault
product_idNoProduct id the plan belongs to.
customer_idYesThe Amberflo customerId to assign the plan to.
product_plan_idYesThe productPlanId of the plan to assign.
end_time_in_secondsNoWhen the plan ends, unix epoch seconds.
start_time_in_secondsNoWhen the plan takes effect, unix epoch seconds.
amberflo_create_customerCreate customer
Destructive
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault
traitsNoArbitrary string traits (key/value metadata).
enabledNoWhether the customer is enabled.
customer_idYesUnique customerId to assign (your identifier for the customer).
customer_nameYesHuman-readable customer name.
customer_emailNoCustomer email address.
create_in_stripeNoWhen true, also auto-create this customer in Stripe (adds ?autoCreateCustomerInStripe=true).
amberflo_explain_usageExplain usage
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
filterNoDimension filter: map of dimension name -> allowed values.
group_byNoDimension names to group by, e.g. ["customerId"].
take_limitNoReturn only the top N records.
aggregationNoAggregation function: SUM | COUNT | MIN | MAX.
meter_api_nameYesThe meterApiName to explain (from amberflo_list_meters).
end_time_in_secondsNoRange end, unix epoch seconds. Defaults to now if omitted.
start_time_in_secondsYesRange start, unix epoch seconds (inclusive).
amberflo_get_all_usageGet all usage
Read-only
Inspect

Get total usage across all meters over a time range, optionally grouped by customer or filtered to one customer. API: GET /usage/all.

ParametersJSON Schema
NameRequiredDescriptionDefault
end_time_in_secondsNoRange end, unix epoch seconds. Defaults to now if omitted.
group_by_customer_idNoWhen true, group results by customer (sends groupBy=customerId).
filter_by_customer_idNoRestrict results to a single customerId.
start_time_in_secondsYesRange start, unix epoch seconds (inclusive).
time_grouping_intervalYesBucket size: HOUR | DAY | WEEK | MONTH.
amberflo_get_customerGet a customer
Read-only
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault
customer_idYesThe Amberflo customerId to fetch.
amberflo_get_customer_invoiceGet customer invoice
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
dayNoDay of month of a specific past invoice.
yearNoYear of a specific past invoice.
monthNoMonth (1-12) of a specific past invoice.
latestNoFetch the current open invoice. Default true. Ignored when a specific invoice is addressed.
from_cacheNoUse cached invoice (faster). Default true.
product_idNoProduct id. Default "1".
customer_idYesThe Amberflo customerId.
product_plan_idNoProduct plan id of a specific past invoice (with year/month/day).
with_payment_statusNoInclude payment status. Default true.
amberflo_get_customer_planGet customer plan
Read-only
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault
customer_idYesThe Amberflo customerId.
amberflo_get_usageQuery usage for a meter
Read-only
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault
filterNoDimension filter: map of dimension name -> allowed values.
group_byNoDimension names to group results by, e.g. ["customerId"].
take_limitNoReturn only the top N groups.
aggregationYesAggregation function: SUM | COUNT | MIN | MAX.
meter_api_nameYesThe meterApiName to query (from amberflo_list_meters).
take_is_ascendingNoSort order for `take` (default false = descending).
end_time_in_secondsNoRange end, unix epoch seconds. Defaults to now if omitted.
start_time_in_secondsYesRange start, unix epoch seconds (inclusive).
time_grouping_intervalYesBucket size: HOUR | DAY | WEEK | MONTH.
amberflo_ingest_usageIngest usage event
Destructive
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
unique_idNoOptional idempotency/unique id for the event.
dimensionsNoOptional dimensions (key/value string metadata) for the event.
customer_idYesThe customerId this usage belongs to.
meter_valueYesThe numeric value of the usage event.
meter_api_nameYesThe meterApiName this event is for.
meter_time_in_millisYesEvent timestamp, unix epoch milliseconds.
amberflo_list_customer_invoicesList customer invoices
Read-only
Inspect

List all invoices for a customer (optionally for a specific product), with payment status. API: GET /payments/billing/customer-product-invoice/all.

ParametersJSON Schema
NameRequiredDescriptionDefault
from_cacheNoUse cached invoices (faster). Default true.
product_idNoProduct id. Default "1".
customer_idYesThe Amberflo customerId.
with_payment_statusNoInclude payment status. Default true.
amberflo_list_customer_plan_historyList customer plan history
Read-only
Inspect

List the full history of product plans assigned to a customer over time. API: GET /payments/pricing/amberflo/customer-pricing/list?CustomerId=.

ParametersJSON Schema
NameRequiredDescriptionDefault
customer_idYesThe Amberflo customerId.
amberflo_list_customersList customers
Read-only
Inspect

List all customers registered in your Amberflo account (id, name, email, traits, enabled). Good first call to discover customer ids. API: GET /customers/.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

amberflo_list_metersList meters
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

amberflo_list_prepaid_ordersList prepaid orders
Read-only
Inspect

List a customer's active prepaid credit orders for a product. API: GET /payments/pricing/amberflo/customer-prepaid/list?CustomerId=&ProductId=.

ParametersJSON Schema
NameRequiredDescriptionDefault
product_idNoProduct id. Default "1".
customer_idYesThe Amberflo customerId.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 14 tool updates
    • Changedamberflo_assign_customer_plan1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_create_customer1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_explain_usage1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_get_all_usage1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_get_customer1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_get_customer_invoice1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_get_customer_plan1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_get_usage1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_ingest_usage1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_list_customer_invoices1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_list_customer_plan_history1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_list_customers1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_list_meters1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedamberflo_list_prepaid_orders1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  2. 14 tool updates
    • First observedamberflo_assign_customer_plan
    • First observedamberflo_create_customer
    • First observedamberflo_explain_usage
    • First observedamberflo_get_all_usage
    • First observedamberflo_get_customer
    • First observedamberflo_get_customer_invoice
    • First observedamberflo_get_customer_plan
    • First observedamberflo_get_usage
    • First observedamberflo_ingest_usage
    • First observedamberflo_list_customer_invoices
    • First observedamberflo_list_customer_plan_history
    • First observedamberflo_list_customers
    • First observedamberflo_list_meters
    • First observedamberflo_list_prepaid_orders

Related MCP Connectors

Related MCP Servers

  • Zenskar MCP Server by zenskar

    Zenskar MCP Serverofficial

    zenskar
    A
    license
    B
    quality
    A
    maintenance
    Enables natural language interaction with the Zenskar billing platform, covering customers, contracts, invoices, payments, accounting, products, plans, and more.
    100
    47 npm
    1
    MIT

  • Usage And Billing MCP Server

    BACH-AI-Tools
    A
    license
    C
    quality
    D
    maintenance
    Enables access to Usage and Billing APIs for managing accounts, products, meters, plans, and usage reporting. Supports operations like creating products/plans, reporting usage, and retrieving billing information.
    18
    MIT
  • ChartMogul MCP Server by chartmogul

    ChartMogul MCP Serverofficial

    chartmogul
    A
    license
    A
    quality
    F
    maintenance
    Enables interaction with the ChartMogul API to manage subscription data, customer relationships, and sales CRM activities. It allows users to retrieve key business metrics like MRR and churn while performing data operations on plans, invoices, and contacts.
    55
    8
    MIT
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources