Skip to main content

Quotas

MCP tools for the Quotas module. See the Quotas module docs for permissions and data model.

list-quotas

List quotas

Arguments

ArgumentTypeRequiredDescription
projectIdstringnoProject ID (required if not using project key auth)
limitnumbernoMaximum number of results to return
offsetnumbernoNumber of results to skip

create-quota

Create a quota

Arguments

ArgumentTypeRequiredDescription
projectIdstringnoProject ID (required if not using project key auth)
scopestringyesThe scope the quota applies to
scopeRefstringnoPublic id of the api key / agent the quota applies to. NULL means all entities of that scope type in the project.
metricstringyesThe metric being capped
windowstringyesThe window over which the metric is aggregated
limitnumberyesThe cap. Must be a positive integer for requests/tokens; fractional values are allowed for cost_usd.
modestringnoenforce blocks with 429 (requests at the middleware, tokens/cost_usd at the pre-generation check); monitor observes without blocking — a breach fires the quota.exceeded webhook and writes a quotas:MonitorBreach audit entry, but the request is let through.

get-quota

Get a quota

Arguments

ArgumentTypeRequiredDescription
quotaIdstringyesQuota ID

update-quota

Update a quota

Arguments

ArgumentTypeRequiredDescription
quotaIdstringyesQuota ID
limitnumbernoNew limit
modestringnoNew mode

delete-quota

Delete a quota

Arguments

ArgumentTypeRequiredDescription
quotaIdstringyesQuota ID