npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

bifrost-mcp

v0.2.0

Published

MCP server for managing a Bifrost LLM gateway's admin API (governance, routing rules, model/pricing config, request logs, gateway config)

Readme

bifrost-mcp

An MCP (Model Context Protocol) server for managing a Bifrost LLM gateway's admin API — governance (virtual keys, teams, customers, budgets), provider configuration, routing rules, model/pricing config, request-log observability, and core gateway config.

This is not the MCP-gateway feature built into Bifrost itself (routing MCP tool calls to LLMs). It's the other direction: it lets an MCP client (Claude Code, Codex, etc.) administer your Bifrost instance — create a virtual key for a new environment, set budgets, add provider API keys, and so on — without leaving your agent session.

Setup

npm install
npm run build

Authentication

Bifrost's /api/* management endpoints accept a Bearer token that is either:

  • a session token from POST /api/session/login, or
  • base64("admin_username:admin_password") — the same admin account you create once via BIFROST_SETUP_TOKEN when you first set up the instance.

Set one of these in your environment:

| Variable | Description | |---|---| | BIFROST_URL | Base URL of your Bifrost instance, e.g. https://bf.example.com. Required. | | BIFROST_ADMIN_USERNAME + BIFROST_ADMIN_PASSWORD | Admin credentials created in the Bifrost dashboard. | | BIFROST_MANAGEMENT_TOKEN | A pre-obtained Bearer token, if you have one, instead of the two above. |

Usage with an MCP client

Add it to your client's MCP config, e.g. .mcp.json for Claude Code:

{
  "mcpServers": {
    "bifrost": {
      "command": "node",
      "args": ["/path/to/bifrost-mcp/dist/index.js"],
      "env": {
        "BIFROST_URL": "https://bf.example.com",
        "BIFROST_ADMIN_USERNAME": "admin",
        "BIFROST_ADMIN_PASSWORD": "your-admin-password"
      }
    }
  }
}

Tools

Virtual keys — bifrost_list_virtual_keys, bifrost_get_virtual_key, bifrost_create_virtual_key, bifrost_update_virtual_key, bifrost_delete_virtual_key, bifrost_rotate_virtual_key, bifrost_get_virtual_key_quota

Teams — bifrost_list_teams, bifrost_get_team, bifrost_create_team, bifrost_update_team, bifrost_delete_team

Customers — bifrost_list_customers, bifrost_get_customer, bifrost_create_customer, bifrost_update_customer, bifrost_delete_customer

Providers — bifrost_list_providers, bifrost_get_provider, bifrost_add_provider, bifrost_delete_provider, bifrost_list_provider_keys, bifrost_add_provider_key, bifrost_delete_provider_key

Routing rules — bifrost_list_routing_rules, bifrost_get_routing_rule, bifrost_create_routing_rule, bifrost_update_routing_rule, bifrost_delete_routing_rule, bifrost_get_complexity_analyzer_config, bifrost_update_complexity_analyzer_config

Budgets & rate limits (read-only aggregate views; create/update happens on the owning virtual key/team/customer/model-config) — bifrost_list_budgets, bifrost_list_rate_limits

Model configs (per-model budget/rate-limit overrides) — bifrost_list_model_configs, bifrost_get_model_config, bifrost_create_model_config, bifrost_update_model_config, bifrost_delete_model_config

Pricing overrides — bifrost_list_pricing_overrides, bifrost_create_pricing_override, bifrost_update_pricing_override, bifrost_delete_pricing_override, bifrost_force_sync_pricing

Model catalog — bifrost_list_models, bifrost_list_base_models, bifrost_get_model_details, bifrost_get_model_parameters

Observability — bifrost_list_request_logs, bifrost_get_request_log, bifrost_get_log_stats, bifrost_get_log_dashboard, bifrost_get_log_histogram, bifrost_get_log_rankings

Gateway config — bifrost_get_config, bifrost_update_config, bifrost_get_proxy_config, bifrost_update_proxy_config, bifrost_get_version, bifrost_list_notifications, bifrost_clear_cache_entry, bifrost_clear_cache

This covers Bifrost's governance hierarchy (Customer → Team → Virtual Key → Provider Config), provider/key management, routing rules, model/pricing config, request-log observability, and core gateway config. Not covered, because these are Enterprise-only features not present in the open-source build: RBAC, access-profiles, business units, audit-log export, the legacy /api/teams /api/users /api/roles /api/access-profiles /api/audit-logs /api/business-units paths (all superseded by /api/governance/* anyway). Also not covered: Bifrost's own MCP-gateway feature (/api/mcp/*, /api/mcp-logs/* — routing MCP tool calls to LLMs, unrelated to administering Bifrost itself), webhooks, plugins, circuit-breaker policies, prompt-repo, and skills. Open an issue or PR if you need any of these.

Development

npm run dev    # run directly with tsx, no build step
npm run lint

License

MIT