Amberflo MCP by usefulapi

Working · 2.2 s

io.usefulapi/amberflov1.21.0 Domain verified

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

Finance & Payments

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://amberflo.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

amberflo_assign_customer_plan Destructive

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

customer_idstring, required

The Amberflo customerId to assign the plan to.

product_plan_idstring, required

The productPlanId of the plan to assign.

product_idstring

Product id the plan belongs to.

end_time_in_secondsinteger

When the plan ends, unix epoch seconds.

start_time_in_secondsinteger

When the plan takes effect, unix epoch seconds.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Argument	Type	Description
traits	object	Arbitrary string traits (key/value metadata).
enabled	boolean	Whether the customer is enabled.
customer_id*	string	Unique customerId to assign (your identifier for the customer).
customer_name*	string	Human-readable customer name.
customer_email	string	Customer email address.
create_in_stripe	boolean	When true, also auto-create this customer in Stripe (adds ?autoCreateCustomerInStripe=true).

Argument	Type	Description
filter	object	Dimension filter: map of dimension name -> allowed values.
group_by	array	Dimension names to group by, e.g. ["customerId"].
take_limit	integer	Return only the top N records.
aggregation	string	Aggregation function: SUM \| COUNT \| MIN \| MAX.
meter_api_name*	string	The meterApiName to explain (from amberflo_list_meters).
end_time_in_seconds	integer	Range end, unix epoch seconds. Defaults to now if omitted.
start_time_in_seconds*	integer	Range start, unix epoch seconds (inclusive).

Argument	Type	Description
end_time_in_seconds	integer	Range end, unix epoch seconds. Defaults to now if omitted.
group_by_customer_id	boolean	When true, group results by customer (sends groupBy=customerId).
filter_by_customer_id	string	Restrict results to a single customerId.
start_time_in_seconds*	integer	Range start, unix epoch seconds (inclusive).
time_grouping_interval*	string	Bucket size: HOUR \| DAY \| WEEK \| MONTH.

Argument	Type	Description
day	integer	Day of month of a specific past invoice.
year	integer	Year of a specific past invoice.
month	integer	Month (1-12) of a specific past invoice.
latest	boolean	Fetch the current open invoice. Default true. Ignored when a specific invoice is addressed.
from_cache	boolean	Use cached invoice (faster). Default true.
product_id	string	Product id. Default "1".
customer_id*	string	The Amberflo customerId.
product_plan_id	string	Product plan id of a specific past invoice (with year/month/day).
with_payment_status

Argument	Type	Description
filter	object	Dimension filter: map of dimension name -> allowed values.
group_by	array	Dimension names to group results by, e.g. ["customerId"].
take_limit	integer	Return only the top N groups.
aggregation*	string	Aggregation function: SUM \| COUNT \| MIN \| MAX.
meter_api_name*	string	The meterApiName to query (from amberflo_list_meters).
take_is_ascending	boolean	Sort order for `take` (default false = descending).
end_time_in_seconds	integer	Range end, unix epoch seconds. Defaults to now if omitted.
start_time_in_seconds*	integer	Range start, unix epoch seconds (inclusive).

Argument	Type	Description
unique_id	string	Optional idempotency/unique id for the event.
dimensions	object	Optional dimensions (key/value string metadata) for the event.
customer_id*	string	The customerId this usage belongs to.
meter_value*	number	The numeric value of the usage event.
meter_api_name*	string	The meterApiName this event is for.
meter_time_in_millis*	integer	Event timestamp, unix epoch milliseconds.

Argument	Type	Description
from_cache	boolean	Use cached invoices (faster). Default true.
product_id	string	Product id. Default "1".
customer_id*	string	The Amberflo customerId.
with_payment_status	boolean	Include payment status. Default true.

Try it

amberflo_assign_customer_plan Destructive

Try it

amberflo_assign_customer_plan Destructive

Tools (14)