Skip to navigation

get_usage_limits

Read usage limits, their live status, alert rules and alerts

Live server: available on mcp.solvimon.com as well as on the test server.

Read-only access to usage limits, their live status, alert rules and fired alerts. Limits are soft caps: Solvimon tracks them and alerts, but never blocks usage or invoicing.

Actions: list, get (status supports get only, with customer_id)

Resource types: limits, status, alert_rules, alerts

status sorts by percentage used and marks over_limit from 100%. include_children groups the result by child customer.

Example prompts

  • “Is Acme Inc. close to its API request cap this billing period?”
  • “Which of Acme Inc.’s child accounts have used more than 80% of their limit?”
  • “List the usage limits configured for this customer.”
  • “Did any overdue-invoice alerts fire recently?”

Example output

Prompt: “Is Acme Inc. close to its API request cap this billing period?”

Tool call:

{
"action": "get",
"resource_type": "status",
"filter": {"customer_id": "cust_gwD6720vzh8etnCOhw1l"}
}

Response (trimmed):

{
"data": [
{
"customer_id": "cust_gwD6720vzh8etnCOhw1l",
"meter_value_calculation_id": "mvca_SwDpzo0vA1bBwlCZ7s1j",
"scope": "SELF",
"limit": {"number": "500000"},
"consumed": {"number": "0"},
"percentage": "0.0",
"over_limit": false,
"meter_value_calculation_name": "Docs example API requests SUM",
"meter_name": "Docs example API requests"
}
]
}

Claude’s answer: No. Acme Inc. has used 0 of its 500,000 API requests this billing period (0%), so it is well under the cap. The limit is a soft cap: Solvimon tracks it but doesn’t block usage.