MCP tool reference

This page is the complete capability catalog of the hosted MCP server: all 22 tools and 90+ operations an enterprise admin can drive, each with a runnable request. It is generated against the same operation registry the portal’s sidebar assistant uses, so the two surfaces cannot drift. Two ways to use everything below:

Ask your agent. With the server connected (Claude Code, Codex, Cursor, a Claude custom connector, …), say the thing — “revoke the CI key that hasn’t been used in 30 days” — and the agent picks the operation, resolves the ids, and walks the consent flow. Every section lists example asks.
Call it yourself. Every operation is one JSON-RPC tools/call POST. Copy any snippet below.

The call, once

All snippets share this exact shape — only the JSON body changes:

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"<tool>","arguments":{…}}}'

Reads go through a domain’s *-query tool as {"query": {"action": …, "input": {…}}}; writes go through *-action as {"proposal": {"action": …, "input": {…}}}. Replace <…-uuid> placeholders with real ids — always resolved from a query tool first, never guessed. How each operation runs (the Runs column below):

Runs	Meaning
immediately	Executes on the call and returns `{"status": "executed", "ok": …, "message": …}` (queries return `{"ok", "message", "data"}`)
after confirm	Returns `needs_confirmation` with a 10-minute `confirmToken`; show the summary to a human, then repeat the call with `"confirmToken"` added to the arguments
portal link	Returns `portal_redemption` with a 15-minute link; the secret renders once in the signed-in portal, never over the API — see consent and secrets

Who sees what. The tool list is computed per request from the connected user’s live role: members get the fixed tools plus personal-*; team leads add their subtree’s membership and budget actions; enterprise admins get everything on this page. Ids in parentheses after each heading are the exact tool names (they surface in Claude Code as mcp__aireserve__<tool>).

Identity & catalog (`whoami`, `list-models`, `get-model`, `get-connection-guide`)

Fixed read tools, available to every role with mcp:read.

“Who is this connection signed in as?” · “Which models can we use right now, and what do they cost?” · “Is deepseek-v3.2 blocked for our org?” · “Give me the base URLs and rate limits for pointing our SDK at the gateway.”

Tool	What it returns	Runs
`whoami`	Acting account, organization, role, authority level, token scopes and expiry	immediately
`list-models`	Every gateway chat model with live pricing (USD per 1M tokens), latency/reasoning traits, org blocklist status, and the org default	immediately
`get-model`	One model by id: pricing, traits, reasoning notes, org availability	immediately
`get-connection-guide`	Gateway base URLs, wire-compatible endpoints (OpenAI, Anthropic, Bedrock), env-var conventions, the org’s effective rate limits, guided connect pages	immediately

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"whoami","arguments":{}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list-models","arguments":{}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get-model","arguments":{"modelId":"claude-sonnet-4-6"}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get-connection-guide","arguments":{}}}'

Each list-models entry looks like:

{
  "id": "claude-sonnet-4-6",
  "name": "Claude Sonnet 4.6",
  "provider": "Anthropic",
  "latency": "medium",
  "reasoning": "advanced",
  "blocked": false,
  "pricing": { "inputPer1mTokens": 3, "outputPer1mTokens": 15 }
}

One-shot inference (`send-message`)

Requires the mcp:messages scope. Sends one prompt through the gateway as the connected user — billed, rate-limited, and visible in usage analytics exactly like their own traffic. Respects the org’s model policy (blocked models are refused; omitted modelId uses the org default).

“Ask kimi-k2 to summarize this changelog.” · “Run this prompt against the org default model.”

Input	Type	Notes
`prompt`	string, required	Up to 32,000 characters
`modelId`	string	From `list-models`; defaults to the org default model
`system`	string	Optional system prompt, up to 8,000 characters
`maxOutputTokens`	int	1–8,192; default 1,024

send-message

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"send-message","arguments":{"prompt":"One sentence: what is an LLM gateway?","modelId":"claude-sonnet-4-6","maxOutputTokens":200}}}'

Returns { "model", "text", "finishReason", "usage": { "inputTokens", "outputTokens" } }. Budget refusals are relayed in plain language (spend cap reached, wallet balance too low).

Personal (`personal-query`, `personal-action`)

Every role. The caller’s own usage, budget, keys, and preferences.

“How much have I spent this week, and on which models?” · “List my API keys with 30-day usage and revoke the one I stopped using.” · “Make gemini-3-flash my default model.”

Operation	What it does	Runs
`get_my_usage_summary`	Usage for your visible scope (self / team / org by role): totals, top models, active users, spend leaderboard; 1, 7, or 30 days; admins and team leads can drill into a team or member	immediately
`get_my_budget_status`	Your spend cap and team budget with remaining headroom	immediately
`list_my_api_keys`	Your API keys, masked, with ids and optional 30-day request counts	immediately
`create_api_key`	Mint a personal inference key	portal link
`revoke_api_key`	Revoke one of your own keys (irreversible)	after confirm
`set_default_model`	Set or clear (`null`) your personal default chat model	immediately

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"personal-query","arguments":{"query":{"action":"get_my_usage_summary","input":{"days":7}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"personal-query","arguments":{"query":{"action":"get_my_budget_status","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"personal-query","arguments":{"query":{"action":"list_my_api_keys","input":{"includeUsage":true}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"personal-action","arguments":{"proposal":{"action":"create_api_key","input":{"name":"CI pipeline"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"personal-action","arguments":{"proposal":{"action":"revoke_api_key","input":{"keyId":"<key-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"personal-action","arguments":{"proposal":{"action":"set_default_model","input":{"modelId":"claude-sonnet-4-6"}}}}}'

Organization API keys (`api-keys-query`, `api-keys-action`)

Enterprise admins. The org’s gateway credentials: listing, usage, minting, revocation, compaction, and live self-tests.

“List all our API keys and flag the ones idle for 30 days.” · “Mint an org key named ‘ETL prod’ bound to Priya for attribution.” · “Revoke key 4354cccc — verify the id against the list first.” · “Run a test ping through the new key.”

Operation	What it does	Runs
`list_client_api_keys`	Every org key — id, masked key, binding (user / team / organization), status, last use	immediately
`get_client_api_key_usage`	Per-key request/token/cost totals, optional `startDate`/`endDate`	immediately
`get_client_api_key_trends`	30-day request count and last-use per key — idle-key detection	immediately
`check_copilot_key_traffic`	Whether a Copilot connect key has served traffic beyond its self-test	immediately
`create_client_api_key`	Mint an org key, optionally bound to a member (`userId`) for attribution and user-scope quota	portal link
`create_team_api_key`	Mint a team-scoped key	portal link
`revoke_client_api_key`	Revoke any org key (irreversible)	after confirm
`set_api_key_compaction`	Toggle always-on context compaction for one key	immediately
`test_api_key`	One-token live ping through a key — verifies auth, model policy, caps, provider (a real metered call)	immediately

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"api-keys-query","arguments":{"query":{"action":"list_client_api_keys","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"api-keys-query","arguments":{"query":{"action":"get_client_api_key_usage","input":{"startDate":"2026-08-01","endDate":"2026-08-19"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"api-keys-query","arguments":{"query":{"action":"get_client_api_key_trends","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"api-keys-query","arguments":{"query":{"action":"check_copilot_key_traffic","input":{"keyId":"<key-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"api-keys-action","arguments":{"proposal":{"action":"create_client_api_key","input":{"name":"ETL prod","userId":"<user-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"api-keys-action","arguments":{"proposal":{"action":"create_team_api_key","input":{"teamId":"<team-uuid>","name":"Data science shared"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"api-keys-action","arguments":{"proposal":{"action":"revoke_client_api_key","input":{"keyId":"<key-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"api-keys-action","arguments":{"proposal":{"action":"set_api_key_compaction","input":{"keyId":"<key-uuid>","enabled":true}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"api-keys-action","arguments":{"proposal":{"action":"test_api_key","input":{"keyId":"<key-uuid>"}}}}}'

Key minting is always a portal link — the fresh secret renders once in the signed-in portal and never crosses the API. The two-step flow exists so an LLM-driven channel can never exfiltrate a live credential.

Members (`members-query`, `members-action`)

Enterprise admins (invite_user also team leads, restricted to regular users on a team in their subtree). Account directory, per-member usage, invitations, roles, lifecycle.

“Invite ada@acme.com to the Data team and send her the onboarding email.” · “Who are our top spenders this month, by model?” · “Deactivate Sam’s account.” · “Promote Priya to enterprise admin.” · “Send Marco a password reset.”

Operation	What it does	Runs
`list_org_users`	Search accounts (email/name), filter by role, include inactive and soft-deleted, paged	immediately
`get_member_usage_totals`	Token and spend totals for up to 25 members by id	immediately
`get_member_usage_by_model`	One member’s usage broken down by model	immediately
`get_shared_key_usage`	Usage from shared org/team keys attributed to no user	immediately
`get_shared_key_usage_by_model`	The same, broken down by model	immediately
`invite_user`	Create an account (role `user` or `enterprise_admin`, optional team) and optionally email the sign-in link	after confirm
`update_member_profile`	Edit name, phone, address, contact notes	immediately
`assign_member_team`	Move a member onto a team, or `null` for Unassigned	immediately
`set_member_active`	Activate or deactivate an account (deactivation locks out every session)	after confirm
`set_user_org_role`	Promote/demote between `user` and `enterprise_admin` (forces re-sign-in)	after confirm
`delete_user`	Soft-delete the account and permanently purge their stored conversations	after confirm
`restore_user`	Restore a soft-deleted account and email a fresh sign-in link	after confirm
`send_password_reset`	Email a live password-reset link	after confirm
`send_onboarding_email`	Send or resend the onboarding email	after confirm

Guard rails the server enforces on every transport: you cannot deactivate or delete yourself, you cannot change your own role, and the last enterprise admin can never be demoted or locked out.

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-query","arguments":{"query":{"action":"list_org_users","input":{"search":"ada"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-query","arguments":{"query":{"action":"get_member_usage_totals","input":{"userIds":["<user-uuid>"],"startDate":"2026-08-01","endDate":"2026-08-19"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-query","arguments":{"query":{"action":"get_member_usage_by_model","input":{"userId":"<user-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-query","arguments":{"query":{"action":"get_shared_key_usage","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-query","arguments":{"query":{"action":"get_shared_key_usage_by_model","input":{"teamId":"<team-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-action","arguments":{"proposal":{"action":"invite_user","input":{"email":"ada@acme.com","name":"Ada Park","role":"user","teamId":"<team-uuid>","sendOnboardingEmail":true}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-action","arguments":{"proposal":{"action":"update_member_profile","input":{"userId":"<user-uuid>","name":"Ada Park-Reyes"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-action","arguments":{"proposal":{"action":"assign_member_team","input":{"userId":"<user-uuid>","teamId":"<team-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-action","arguments":{"proposal":{"action":"set_member_active","input":{"userId":"<user-uuid>","active":false}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-action","arguments":{"proposal":{"action":"set_user_org_role","input":{"userId":"<user-uuid>","role":"enterprise_admin"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-action","arguments":{"proposal":{"action":"delete_user","input":{"userId":"<user-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-action","arguments":{"proposal":{"action":"restore_user","input":{"userId":"<user-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-action","arguments":{"proposal":{"action":"send_password_reset","input":{"userId":"<user-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"members-action","arguments":{"proposal":{"action":"send_onboarding_email","input":{"userId":"<user-uuid>"}}}}}'

Teams & budgets (`teams-budgets-query`, `teams-budgets-action`)

Enterprise admins; team leads can move members within their own subtree, allocate budget to teams strictly below their own node, and grant/revoke manager status inside their org. The envelope model: org cap → team allocations → Unassigned pool → per-user caps.

“Create a Research sub-team under Engineering and give it $2,000."* · *"Show the allocation table — who has headroom?"* · *"Cap Anna at $150 with 60 requests a minute.” · “Move these five people to Platform.” · “Make Jordan a manager.”

Operation	What it does	Runs
`get_team_allocations`	The full budget table: org cap, per-team allocations and spend, Unassigned pool, headroom	immediately
`list_user_spend_caps`	Per-user caps with lifetime spend (only capped users appear)	immediately
`get_client_spend_summary`	Org-wide cap, current spend, budget period	immediately
`create_team`	New team, optionally under `parentTeamId`	immediately
`rename_team`	Rename a team	immediately
`delete_team`	Delete an empty team (refused while it has members or sub-teams)	after confirm
`assign_user_to_team`	Move one member to a team or Unassigned (`null`; admins only for Unassigned)	immediately
`bulk_assign_users_to_team`	Move up to 25 members atomically	after confirm
`set_team_cap`	Set a team’s total (subtree) allocation in USD	immediately
`remove_team_cap`	Remove a team’s explicit allocation	immediately
`set_unassigned_pool_cap`	Cap the Unassigned pool	immediately
`remove_unassigned_pool_cap`	Team-less users fall back to the org cap	immediately
`set_user_boss_status`	Grant or dissolve a member’s manager role (their own org node)	after confirm
`set_user_spend_cap`	Personal spend cap in USD, optional requests/minute and requests/day	immediately
`remove_user_spend_cap`	Back to team/org limits	immediately
`set_client_spend_cap`	Set or clear (`null`) the org-wide ceiling — all traffic stops when reached	after confirm

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-query","arguments":{"query":{"action":"get_team_allocations","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-query","arguments":{"query":{"action":"list_user_spend_caps","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-query","arguments":{"query":{"action":"get_client_spend_summary","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"create_team","input":{"name":"Research","parentTeamId":"<team-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"rename_team","input":{"teamId":"<team-uuid>","name":"Applied Research"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"delete_team","input":{"teamId":"<team-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"assign_user_to_team","input":{"userId":"<user-uuid>","teamId":"<team-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"bulk_assign_users_to_team","input":{"userIds":["<user-uuid>","<user-uuid>"],"teamId":"<team-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"set_team_cap","input":{"teamId":"<team-uuid>","budgetLimitUsd":2000}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"remove_team_cap","input":{"teamId":"<team-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"set_unassigned_pool_cap","input":{"budgetLimitUsd":500}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"remove_unassigned_pool_cap","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"set_user_boss_status","input":{"userId":"<user-uuid>","makeBoss":true}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"set_user_spend_cap","input":{"userId":"<user-uuid>","budgetLimitUsd":150,"requestsPerMinute":60}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"remove_user_spend_cap","input":{"userId":"<user-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"teams-budgets-action","arguments":{"proposal":{"action":"set_client_spend_cap","input":{"capUsd":10000}}}}}'

Analytics (`analytics-query`)

Enterprise admins, read-only (there is no analytics-action). Compact aggregates by design — top-5 lists, one 20-row log page, capped vocabularies — with request metadata only: prompt and response content never crosses this surface.

“What did we spend last month, split input/output/cached?” · “Show failed gateway requests from yesterday.” · “Which business functions drive our AI spend?” · “Give me a usage summary for June 1 to June 30.”

Operation	What it does	Runs
`get_spend_breakdown`	30-day USD split: input / output / cached, plus request count	immediately
`get_gateway_usage_stats`	Aggregate totals (requests, tokens, spend, latency, errors) filtered by date / model / provider / status / user	immediately
`get_gateway_request_log`	One page (≤20 rows) of the request log: who called which model, when, cost, status; cursor-paged over a stable snapshot	immediately
`get_business_function_usage`	Usage grouped by business function and team, top 25 by cost	immediately
`get_gateway_filter_options`	The legal filter values for the two ops above	immediately
`get_analytics_dashboard`	Analytics summary for a preset (1/7/30 days) or custom range (≤366 days), scoped to org, a team subtree, or a member set	immediately
`get_model_usage_year`	Trailing-365-day model rollup, top 5 by spend	immediately

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analytics-query","arguments":{"query":{"action":"get_spend_breakdown","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analytics-query","arguments":{"query":{"action":"get_gateway_usage_stats","input":{"startDate":"2026-08-01","endDate":"2026-08-19","model":"claude-sonnet-4-6"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analytics-query","arguments":{"query":{"action":"get_gateway_request_log","input":{"startDate":"2026-08-18","status":"failure","limit":20}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analytics-query","arguments":{"query":{"action":"get_business_function_usage","input":{"startDate":"2026-08-01"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analytics-query","arguments":{"query":{"action":"get_gateway_filter_options","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analytics-query","arguments":{"query":{"action":"get_analytics_dashboard","input":{"from":"2026-06-01","to":"2026-06-30"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analytics-query","arguments":{"query":{"action":"get_model_usage_year","input":{}}}}}'

Models & routing (`models-routing-query`, `models-routing-action`)

Enterprise admins. The org’s model policy (default model, selection lock, blocklist) and the Auto-router (enrollment, tuning, bring-your-own endpoint).

“Set the org default to Auto routing.” · “Block the models that train on inputs.” · “Rebalance the router 60% smarter / 30% cheaper / 10% faster.” · “Which providers serve Kimi K2 right now, and at what price and uptime?”

Operation	What it does	Runs
`get_model_provider_endpoints`	Live per-provider pricing, uptime, and throughput for one catalog model	immediately
`set_org_default_model`	Set the org default chat model — a model id, `"auto"` for Auto Routing, or `null` for the platform default	immediately
`set_model_governance`	Lock model selection to the default and/or replace the org blocklist or its blocked-maker list (`blockedModelMakers`, every current and future model of a maker; each list is a full replacement and `[]` clears it)	immediately
`update_router_selections`	Replace Auto-router enrollment and/or its blocklist (full replacement; `[]` clears)	immediately
`update_router_tuning`	Rebalance smarter/cheaper/faster (must sum to 100) and/or replace the plain-language routing rules	after confirm
`update_provider_preference`	Choose which host serves open-weight models served by several providers: a preset (`cheapest`, `fastest`, `most_reliable`, `balanced`) or `custom` price/latency/reliability weights, provider exclusions, and conversation stickiness	after confirm
`set_router_endpoint`	Live-test a bring-your-own router URL and save it only if the test passes	after confirm
`clear_router_endpoint`	Back to the built-in Auto router	after confirm

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"models-routing-query","arguments":{"query":{"action":"get_model_provider_endpoints","input":{"modelId":"anthropic/claude-sonnet-4.6"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"models-routing-action","arguments":{"proposal":{"action":"set_org_default_model","input":{"modelId":"auto"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"models-routing-action","arguments":{"proposal":{"action":"set_model_governance","input":{"modelSelectionLocked":false,"blockedModelIds":["deepseek-chat"]}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"models-routing-action","arguments":{"proposal":{"action":"update_router_selections","input":{"routerModelIds":["anthropic/claude-sonnet-4.6","openai/gpt-5.5"]}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"models-routing-action","arguments":{"proposal":{"action":"update_router_tuning","input":{"tuning":{"smarter":60,"cheaper":30,"faster":10}}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"models-routing-action","arguments":{"proposal":{"action":"update_provider_preference","input":{"preset":"cheapest","excludedProviders":["baseten"]}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"models-routing-action","arguments":{"proposal":{"action":"set_router_endpoint","input":{"endpointUrl":"https://router.acme.com/route","method":"POST"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"models-routing-action","arguments":{"proposal":{"action":"clear_router_endpoint","input":{}}}}}'

Org settings (`org-settings-query`, `org-settings-action`)

Enterprise admins. Org-wide chat text, privacy controls, branding, sign-in access, and business-function classification review.

“Turn off storage of prompt and response text.” · “Set content retention to 30 days.” · “Open self-serve sign-up for acme.com.” · “What classification questions are waiting on me?” · “What needs my attention today?”

Operation	What it does	Runs
`get_stored_content_count`	How many conversation rows a purge would delete	immediately
`get_org_branding`	Whitelabeling flag, window title, logo presence	immediately
`list_signin_domains`	Verified sign-in email domains and their self-serve status	immediately
`list_needs_input_classifications`	Keys/teams/users whose classification awaits an admin answer	immediately
`list_classification_records`	Classification records with date/category/state filters, cursor-paged	immediately
`get_classification_summary`	Labeled-coverage totals	immediately
`get_classification_provenance`	Why one usage row carries its label	immediately
`get_needs_attention`	Today’s admin to-dos: budget alerts, stale keys, spend spikes	immediately
`update_org_instructions`	Replace/toggle the org-wide chat instructions	after confirm
`update_org_context`	Replace/toggle the org context text shared with every chat	after confirm
`set_content_logging`	Turn storage of prompt/response text on or off	immediately
`set_content_retention`	Days before the scheduled purge deletes stored chat content (`null` = keep)	after confirm
`purge_stored_content`	Permanently delete ALL stored conversation content	after confirm
`set_whitelabeling`	Toggle whitelabeled branding	immediately
`set_window_title`	Set or clear (`""`) the custom browser title	immediately
`remove_org_logo`	Remove the logo (also disables whitelabeling)	after confirm
`set_domain_auto_provision`	Open or close self-serve sign-up for a verified domain	after confirm
`set_classification_enabled`	Toggle business-function classification of new usage	immediately
`answer_classification_question`	Answer an open question — re-buckets all usage under that key/team/user	immediately
`confirm_classification`	Confirm or correct one usage row’s label	immediately
`clear_classification`	Clear one usage row’s label	immediately
`dismiss_attention_items`	Dismiss the current needs-attention items	immediately

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-query","arguments":{"query":{"action":"get_needs_attention","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-query","arguments":{"query":{"action":"get_stored_content_count","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-query","arguments":{"query":{"action":"get_org_branding","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-query","arguments":{"query":{"action":"list_signin_domains","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-query","arguments":{"query":{"action":"list_needs_input_classifications","input":{"limit":10}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-query","arguments":{"query":{"action":"list_classification_records","input":{"state":"needs_input","pageSize":10}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-query","arguments":{"query":{"action":"get_classification_summary","input":{"startDate":"2026-08-01"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-query","arguments":{"query":{"action":"get_classification_provenance","input":{"usageLogId":"<usage-row-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"update_org_instructions","input":{"text":"Answer in the metric system. Cite internal wiki pages where relevant.","enabled":true}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"update_org_context","input":{"text":"Acme builds industrial robotics. Fiscal year starts in February.","enabled":true}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"set_content_logging","input":{"enabled":false}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"set_content_retention","input":{"days":30}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"purge_stored_content","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"set_whitelabeling","input":{"enabled":true}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"set_window_title","input":{"title":"Acme AI"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"remove_org_logo","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"set_domain_auto_provision","input":{"domainId":"<domain-uuid>","enabled":true}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"set_classification_enabled","input":{"enabled":true}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"answer_classification_question","input":{"assignmentId":"<assignment-uuid>","category":"engineering"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"confirm_classification","input":{"usageLogId":"<usage-row-uuid>","category":"sales"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"clear_classification","input":{"usageLogId":"<usage-row-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"org-settings-action","arguments":{"proposal":{"action":"dismiss_attention_items","input":{}}}}}'

Files (`files-query`, `files-action`)

Enterprise admins. The organization’s stored files. Uploads stay in the portal (an API can’t supply file bytes through a consent card); everything else is here.

“List our shared files — anything named ‘onboarding’?” · “Get me a download link for the Q2 board deck.” · “Delete the stale export from May.”

Operation	What it does	Runs
`list_org_files`	Shared files with name, type, size, upload date; searchable, paged	immediately
`get_file_download_link`	Mint a one-hour signed download URL (a bearer capability, so it renders in the portal only)	portal link
`delete_org_file`	Delete a stored file (irreversible)	after confirm

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"files-query","arguments":{"query":{"action":"list_org_files","input":{"search":"onboarding"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"files-action","arguments":{"proposal":{"action":"get_file_download_link","input":{"documentId":"<document-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"files-action","arguments":{"proposal":{"action":"delete_org_file","input":{"documentId":"<document-uuid>"}}}}}'

Billing (`billing-query`, `billing-action`)

Enterprise admins. The yield-to-compute wallet, the immutable ledger mirror, and CARR reporting. Money movements are the most conservative operations on the surface — every one confirms, and none can be undone.

“What’s our wallet balance and last epoch’s yield?” · “List the credits into the wallet this quarter.” · “Close the July ledger period and generate the CARR summary.”

Operation	What it does	Runs
`get_wallet_summary`	Current wallet balance and last-epoch yield	immediately
`list_wallet_credits`	Credits into the wallet — funding, sweeps, transfers in	immediately
`get_ledger_balance`	Ledger rollup: opening/closing balance, additions, consumption, recent events	immediately
`list_ledger_periods`	Closed-and-hashed periods with record counts and hashes	immediately
`generate_carr_report`	CARR summary figures for a period (file exports stay on `/admin/carr`)	immediately
`transfer_client_funds`	Move USD from your wallet to another client’s — requires a caller-minted `idempotencyKey` (reuse the same key on retry; a fresh key is a second transfer)	after confirm
`close_ledger_period`	Close a usage period and anchor it into the immutable hash chain — can never be reopened	after confirm

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"billing-query","arguments":{"query":{"action":"get_wallet_summary","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"billing-query","arguments":{"query":{"action":"list_wallet_credits","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"billing-query","arguments":{"query":{"action":"get_ledger_balance","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"billing-query","arguments":{"query":{"action":"list_ledger_periods","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"billing-query","arguments":{"query":{"action":"generate_carr_report","input":{"periodStart":"2026-07-01T00:00:00Z","periodEnd":"2026-07-31T23:59:59Z"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"billing-action","arguments":{"proposal":{"action":"transfer_client_funds","input":{"toClientId":"<client-uuid>","amountUsd":250,"idempotencyKey":"<mint-one-uuid-per-transfer>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"billing-action","arguments":{"proposal":{"action":"close_ledger_period","input":{"periodStart":"2026-07-01T00:00:00Z","periodEnd":"2026-07-31T23:59:59Z"}}}}}'

GPU compute (`compute-query`, `compute-action`)

Enterprise admins. The provider-hidden GPU flow from the Compute › GPUs page: price a machine, launch it with persistent storage, see how to connect, stop it when done. The same placement check and wallet spend gate as the portal run on every call; no provider, data-center or tenancy identifier ever enters or leaves these tools. Quote first, then launch with the quoteId — the user approves the exact all-in price they were shown.

“Quote one H100 with 200 GB of persistent storage in Europe, then launch it under $4/hour.” · “List my GPU machines and stop anything idle.” · “How do I SSH into train-7?”

Operation	What it does	Runs
`list_gpu_offers`	GPU models in stock now with per-GPU hourly price and stock level	immediately
`quote_gpu_instance`	All-in price (GPU, root disk, optional new or attached persistent volume) and a `quoteId`; creates nothing	immediately
`launch_gpu_instance`	Launch from a `quoteId`, or from a request plus a `maxHourlyPrice` ceiling; opens hourly billing	after confirm
`list_gpu_machines`	Machines with state, GPUs, hourly rate, attached volume	immediately
`get_gpu_machine`	One machine: image, ports, volume, recovery, and the SSH command / exposed URLs	immediately
`get_gpu_machine_logs`	The last ~200 lines of container output	immediately
`stop_gpu_machine` / `start_gpu_machine`	Pause and resume (root disk lost on stop; a persistent volume survives)	immediately
`terminate_gpu_machine`	Destroy the machine and its root disk	after confirm
`list_gpu_volumes`	Persistent volumes: size, region, storage rate, state, attached machine	immediately
`delete_gpu_volume`	Delete a detached volume and its data	after confirm

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"compute-query","arguments":{"query":{"action":"quote_gpu_instance","input":{"accelerator":"H100_80GB","count":1,"region":"europe","storage":{"persistentGb":200,"mountPath":"/data"},"maxHourlyPrice":"4.00"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"compute-action","arguments":{"proposal":{"action":"launch_gpu_instance","input":{"quoteId":"<quoteId-from-the-quote>","name":"train-7","sshPublicKey":"ssh-ed25519 AAAA…"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"compute-query","arguments":{"query":{"action":"get_gpu_machine","input":{"podId":"<machine-uuid>"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"compute-action","arguments":{"proposal":{"action":"stop_gpu_machine","input":{"podId":"<machine-uuid>"}}}}}'

A launch_gpu_instance with a persistent storage block creates the volume in the GPU’s location inside the same transaction as the machine; pass an existing volumeId instead to pin placement to where that volume already lives. A no_capacity refusal carries the reason (price_ceiling, volume_location, no_persistent_storage, no_stock), the cheapest eligible price and alternatives, so the agent can propose what would work.

Containers (`containers-query`, `containers-action`)

Enterprise admins. Containers & Orchestration › Elastic Container Service, end to end: enable the organization’s own AWS account behind the ECS passthrough, mint an ECS credential (a real AWS access key pair — it renders in the portal, never to the agent), get the exact ~/.aws/config lines that repoint ECS and CloudWatch Logs at the gateway, deploy an image to an HTTPS URL, scale, redeploy, read logs, clean up. Web holds no AWS credential on any path; the gateway signs each call in the organization’s account.

“Enable Containers, create an ECS credential and set up an aireserve AWS profile so aws ecs list-clusters works.” · “Deploy ghcr.io/acme/api:1.4 as a public service in us-east-1 and tail its logs.” · “Scale the worker service to zero overnight.”

Operation	What it does	Runs
`get_containers_account`	Enabled? Lifecycle state (`requested → vending → provisioning → active`), AWS account id, credentials (names and key hints)	immediately
`get_containers_connection_guide`	Endpoint URL, the `~/.aws/config` profile, env vars, SDK one-liners, verify commands	immediately
`enable_containers`	Create the organization’s AWS account (idempotent; active within minutes)	after confirm
`create_ecs_credential`	Mint an AWS access key pair; the `~/.aws/credentials` block renders once in the portal	portal link
`revoke_ecs_credential`	Revoke a pair	after confirm
`list_ecs_clusters` / `get_ecs_cluster`	Clusters in a region with counts and this month’s Fargate usage; one cluster’s services and tasks	immediately
`get_ecs_service` / `get_ecs_task`	A service (with its HTTPS URL, image, size, scaling, log group when deployed from here); a task’s containers and log streams	immediately
`list_ecs_task_definitions`	Families with their latest revision	immediately
`get_ecs_logs`	CloudWatch events for a task or service, newest 200, optional filter	immediately
`deploy_container_service`	Image in, `https://<name>.ecs.<region>.on.aws` out (ECS Express Mode)	after confirm
`update_container_service`	New image, size, variables or scaling bounds on a deployed service	immediately
`scale_ecs_service` / `redeploy_ecs_service` / `stop_ecs_task` / `create_ecs_cluster`	The everyday buttons	immediately
`delete_ecs_service` / `delete_ecs_cluster`	Remove a service (and its URL); remove an empty cluster	after confirm

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"containers-action","arguments":{"proposal":{"action":"enable_containers","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"containers-action","arguments":{"proposal":{"action":"create_ecs_credential","input":{"name":"my laptop"}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"containers-query","arguments":{"query":{"action":"get_containers_connection_guide","input":{}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"containers-action","arguments":{"proposal":{"action":"deploy_container_service","input":{"region":"us-east-1","image":"ghcr.io/acme/api:1.4","containerPort":8080,"minTasks":1,"maxTasks":4}}}}}'

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"containers-query","arguments":{"query":{"action":"get_ecs_logs","input":{"region":"us-east-1","logGroupName":"/ecs/api","sinceMinutes":30}}}}}'

The agent’s happy path for a new organization: enable_containers → create_ecs_credential (hand the user the portal link; they paste the pair into ~/.aws/credentials) → get_containers_connection_guide (write the [profile aireserve] block into ~/.aws/config) → aws ecs list-clusters --profile aireserve → deploy_container_service.

Completing a confirmation

Any operation marked after confirm returns a confirmToken on the first call. After a human approves the returned summary, repeat the identical call with the token added alongside the proposal:

confirm-retry

curl https://api.aireserve.com/mcp \
  -H "Authorization: Bearer $AIRESERVE_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"members-action","arguments":{"proposal":{"action":"set_member_active","input":{"userId":"<user-uuid>","active":false}},"confirmToken":"<confirmToken-from-step-1>"}}}'

The token binds the exact operation, input, and caller the human saw; it expires after 10 minutes, and if the target row changed in between, execution refuses with a fresh summary to re-approve.

Not on this surface

By design, the MCP server never exposes:

Platform (cross-tenant) operations — funding client wallets, wallet enforcement toggles, ledger syncs, sign-in-domain registration, cross-org lookups. Super admins are de-escalated to their own tenant here; platform work stays in the portal.
Secrets in responses — key material and signed download URLs only ever render in the signed-in portal via redemption links.
Impersonation and file-byte uploads — both remain portal page flows.
Prompt/response content — analytics reads return request metadata only.

Getting started

Connect your tool

GPU Infrastructure

Containers & orchestration

Capabilities

Migrate

Performance

Data & privacy

Reliability

The call, once

Identity & catalog (`whoami`, `list-models`, `get-model`, `get-connection-guide`)

One-shot inference (`send-message`)

Personal (`personal-query`, `personal-action`)

Organization API keys (`api-keys-query`, `api-keys-action`)

Members (`members-query`, `members-action`)

Teams & budgets (`teams-budgets-query`, `teams-budgets-action`)

Analytics (`analytics-query`)

Models & routing (`models-routing-query`, `models-routing-action`)

Org settings (`org-settings-query`, `org-settings-action`)

Files (`files-query`, `files-action`)

Billing (`billing-query`, `billing-action`)

GPU compute (`compute-query`, `compute-action`)

Containers (`containers-query`, `containers-action`)

Completing a confirmation

Not on this surface

​The call, once

​Identity & catalog (whoami, list-models, get-model, get-connection-guide)

​One-shot inference (send-message)

​Personal (personal-query, personal-action)

​Organization API keys (api-keys-query, api-keys-action)

​Members (members-query, members-action)

​Teams & budgets (teams-budgets-query, teams-budgets-action)

​Analytics (analytics-query)

​Models & routing (models-routing-query, models-routing-action)

​Org settings (org-settings-query, org-settings-action)

​Files (files-query, files-action)

​Billing (billing-query, billing-action)

​GPU compute (compute-query, compute-action)

​Containers (containers-query, containers-action)

​Completing a confirmation

​Not on this surface

The call, once

Identity & catalog (`whoami`, `list-models`, `get-model`, `get-connection-guide`)

One-shot inference (`send-message`)

Personal (`personal-query`, `personal-action`)

Organization API keys (`api-keys-query`, `api-keys-action`)

Members (`members-query`, `members-action`)

Teams & budgets (`teams-budgets-query`, `teams-budgets-action`)

Analytics (`analytics-query`)

Models & routing (`models-routing-query`, `models-routing-action`)

Org settings (`org-settings-query`, `org-settings-action`)

Files (`files-query`, `files-action`)

Billing (`billing-query`, `billing-action`)

GPU compute (`compute-query`, `compute-action`)

Containers (`containers-query`, `containers-action`)

Completing a confirmation

Not on this surface