oviron avatar

Openrouter Admin

oviron/openrouter-admin-mcp

If you manage OpenRouter programmatically or need to audit spend without clicking through the web UI, this server wraps the full management API. It exposes 26 tools for credits, inference key CRUD with daily/weekly/monthly limits, guardrails with provider allowlists, activity breakdowns by model or day, and generation lookups by ID. The overview tool gives you a single dashboard snapshot of balance, active keys, and today's burn. Write operations (create, update, delete) are opt-in via environment flag to prevent accidental mutations. Useful when you're rotating keys with budget caps, drilling into cost spikes, or binding guardrails to org members from Claude Desktop or Cursor instead of the browser.

tools
24
auth
Secret needed
transport
STDIO
env vars
2
last updated
Apr 26, 2026

Tools

24 tools

Public tool metadata for what this MCP can expose to an agent.

or_overviewOne-shot dashboard: credits + active keys + today's burn by model.

One-shot dashboard: credits + active keys + today's burn by model.

No parameter schema in public metadata yet.

or_creditsAccount balance: total purchased, total used, remaining.

Account balance: total purchased, total used, remaining.

No parameter schema in public metadata yet.

or_current_keyMetadata of the Provisioning key the server is using.

Metadata of the Provisioning key the server is using.

No parameter schema in public metadata yet.

or_keys_listAll inference keys with usage, limits, reset cadence, expiration.

All inference keys with usage, limits, reset cadence, expiration.

No parameter schema in public metadata yet.

or_key_getDetailed view of one key by hash.

Detailed view of one key by hash.

No parameter schema in public metadata yet.

or_activityUsage for the last 30 UTC days with filters and aggregations.

Usage for the last 30 UTC days with filters and aggregations.

No parameter schema in public metadata yet.

or_generationFetch a single inference call by its gen-… id (cost, tokens, latency, finish reason).

Fetch a single inference call by its gen-… id (cost, tokens, latency, finish reason).

No parameter schema in public metadata yet.

or_modelsModel catalog with per-1M pricing, context length, modalities. Filterable.

Model catalog with per-1M pricing, context length, modalities. Filterable.

No parameter schema in public metadata yet.

or_model_getFull details for one model id.

Full details for one model id.

No parameter schema in public metadata yet.

or_model_endpointsPer-provider endpoints for a model: pricing, uptime, status.

Per-provider endpoints for a model: pricing, uptime, status.

No parameter schema in public metadata yet.

or_models_userModels filtered by your account's privacy/guardrail settings.

Models filtered by your account's privacy/guardrail settings.

No parameter schema in public metadata yet.

or_zdr_endpointsZDR-compliant endpoints for privacy-constrained workflows.

ZDR-compliant endpoints for privacy-constrained workflows.

No parameter schema in public metadata yet.

or_guardrails_listAll guardrails: limit_usd, reset, allow/block lists, ZDR.

All guardrails: limit_usd, reset, allow/block lists, ZDR.

No parameter schema in public metadata yet.

or_guardrail_getFull details for one guardrail.

Full details for one guardrail.

No parameter schema in public metadata yet.

or_guardrails_assignmentsComposite — which keys/members are bound to which guardrail.

Composite — which keys/members are bound to which guardrail.

No parameter schema in public metadata yet.

or_org_membersMembers of the OpenRouter organization (Management-key + org account).

Members of the OpenRouter organization (Management-key + org account).

No parameter schema in public metadata yet.

or_key_createCreate a new inference key. Returns the one-time secret.

Create a new inference key. Returns the one-time secret.

No parameter schema in public metadata yet.

or_key_updateUpdate name / disabled / limit / limit_reset / expires_at.

Update name / disabled / limit / limit_reset / expires_at.

No parameter schema in public metadata yet.

or_key_deletePermanently delete a key.

Permanently delete a key.

No parameter schema in public metadata yet.

or_guardrail_createCreate a guardrail.

Create a guardrail.

No parameter schema in public metadata yet.

or_guardrail_updateUpdate a guardrail.

Update a guardrail.

No parameter schema in public metadata yet.

or_guardrail_deleteDelete a guardrail.

Delete a guardrail.

No parameter schema in public metadata yet.

or_guardrail_assign_keysBulk-assign a guardrail to inference keys.

Bulk-assign a guardrail to inference keys.

No parameter schema in public metadata yet.

or_guardrail_assign_membersBulk-assign a guardrail to org members.

Bulk-assign a guardrail to org members.

No parameter schema in public metadata yet.

Sponsors

Configuration

OPENROUTER_PROVISIONING_KEY*secret

OpenRouter Provisioning API key — create at https://openrouter.ai/settings/provisioning. Distinct from inference keys: it can manage your account but cannot make completion calls.

OPENROUTER_ADMIN_ALLOW_WRITE

Set to '1' to enable destructive write tools (or_key_create, or_key_update, or_key_delete). Disabled by default — read-only tools (or_overview, or_credits, or_keys_list, or_key_get, or_activity, or_current_key) are always available.

Readme

openrouter-admin-mcp

npm version npm downloads CI MCP Registry Node License: MIT

MCP server for the OpenRouter management API — programmatic control of credits, inference keys, guardrails, organization members, and usage analytics from inside Claude Code, Claude Desktop, Cursor, or any MCP-compatible client.

demo


View the full README on GitHub

Details

Repository
github.com/oviron/openrouter-admin-mcp
Category
Data & Analytics
Package
openrouter-admin-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Data & Analytics MCP servers

View all
1owenscheuer avatarPaceva for Garminowenscheuer/paceva-garmin-mcpYour own Garmin Connect data: sleep, HRV, Body Battery and activities. Local, read-only.0stars
2parvenudev avatarParvenuparvenudev/parvenu_mcp_directory_integrationB2B lead sourcing and enrichment: lead lists with verified emails, LinkedIn and company data.0stars
3pipeworx-io avatarAbgeordnetenwatchpipeworx-io/mcp-abgeordnetenwatchAbgeordnetenwatch MCP — German federal & state parliament data.0stars
4pipeworx-io avatarAbs Aupipeworx-io/mcp-abs-auAustralian Bureau of Statistics (ABS) Data API MCP.0stars
5pipeworx-io avatarAcledpipeworx-io/mcp-acledACLED MCP — Armed Conflict Location & Event Data Project0stars
6pipeworx-io avatarAlphavantagepipeworx-io/mcp-alphavantageAlpha Vantage MCP — Stock market data, fundamentals, and earnings0stars