Skip to content
RouterX
 
Traffic paused
Overview Playground
Observe
Requests Spend & savings Reliability
Configure
API keys Providers MCP servers
Govern
Guardrails & policy Members Compliance
Settings API reference
RouterX
Can't reach the gateway. What's on screen may be out of date. Checking again every 15 seconds.
Couldn't load your account. Controls for your role stay hidden until it loads.
Gateway paused. Every chat request from this organization is refused with HTTP 503 until an owner or admin resumes traffic.
Overview

Overview

 

Open playground Add provider Create API key
Spend this month
–
 
Requests
–
All time
Cache hit rate
–
Exact and semantic cache combined
Tokens saved
–
By prompt optimization and cache
Saved by routing
–
This month, in dollars

What you can do here

You're signed in as  . Owners and admins set providers, spend caps, MCP servers and guardrails; their rules apply to you too.

Create an API key for your applicationAPI keys
Try a prompt through the gatewayPlayground
Connect your own accounts for MCP toolsMCP servers
Read the organization's guardrails and spend capGuardrails

Needs attention

 

    This month at each checkpoint

     

      Rate limit, Replay and Inspect have no per-request count. Refusals are under Requests, Refused.

      Get set up

       
      Enforcement

      Every call checked before it runs.

      Traffic–
      MCP tool execution–
      SQL tables tools may read–
      Hosts MCP servers may use–
      Two-step verification–
      Data residency–
      Review guardrails

      Recent requests

      All requests
      TimeModelLatencyCostOutcome

      The last 50 requests, kept up to 7 days.

      Providers

      Manage

      Page not available

       

      Go to Overview

      Playground

      Playground

      Send a prompt through policy, cache, routing and guardrails. Type @ to attach an MCP tool.

      MCP tool execution is off, so attached tools won't be used. An owner or admin can turn it on under Guardrails & policy.

      No files attached. Drop them on this card, or use Attach.

      Documents (PDF, Word, Excel, CSV, text, Markdown, JSON, YAML, logs) up to 10 MB each. Images (PNG, JPEG, GIF, WebP) up to 5 MB, when your organization allows them.

      Options

      Copy this request as or

      A forced tier skips the caches and is left out of savings.

      Gateway output

        The answer appears here.

        
                    

        Routing receipt

        Configure · API keys

        API keys

        Keys your applications use to call the gateway.

        Keys

         
        KeyLast usedLimitsStatusActions

        A key is shown once. If one is lost, rotate it.

        Connect an application

        Works with any OpenAI-compatible SDK or tool. RouterX picks the provider and model.

        Base URL
        
                    

        Endpoints: /chat/completions, /responses, /embeddings, and /mcp/execute for MCP tools.

        Optional headers
        X-Session-Id
        One id per conversation (up to 128 letters, digits, . _ : -). With session features on (Settings > Auto-routing), its turns keep one tier and provider, so prompt caches stay warm.
        X-Trace-Id
        One id per agent task; its requests and tool calls are grouped under Requests > Agent tasks.
        Configure · Providers

        Providers

        The providers this organization routes to, with your own keys. Keys are encrypted at rest and never sent back to the browser.

        Active providers

        The next provider is tried if one fails.

        Read-only: owners and admins add, change and remove providers.

        PriorityProviderRegionStatusActions

        Models RouterX knows

        Every model with a price, which an API key or a routing rule may name. Prices per million tokens.

        ModelTierInputOutput
        Configure · MCP servers

        MCP servers

        Tool servers models can call. Every call is checked and logged.

        Owners and admins set up MCP servers. If one of them needs your own account, connect it below.

        Servers

        Type @ in the Playground to attach one of these to a prompt.

        OAuth providers

        Apps people sign in through to link their own accounts.

        My OAuth connections

        Your accounts, for MCP servers that act as you.

        Govern · Guardrails & policy

        Guardrails & policy

        Organization controls, routing rules, the policy and shadow evaluation. Saved changes apply to the next request.

        The rules in force

        What every request here is held to, yours included. Owners and admins change them; you're signed in as  .

        Organization controls

        Read-only: changing these controls requires the owner or admin role.

        Two-step verification Loading Not saved

        Password sign-ins also need an authenticator code (single sign-on doesn't). Set yours up first, in Settings.

        Images in requests Loading Not saved

        Lets requests carry images (PNG, JPEG, GIF, WebP). PII redaction reads text only, so images reach the provider unscanned, and only models that see images get them.

        MCP tool execution Loading Not saved

        Lets models call tools on this organization's MCP servers, within the guardrails.

        Tables MCP tools may read Loading Not saved

        Comma-separated, e.g. support_tickets, orders. Empty: none; *: all. Use schema.table outside the default schema.

        Hosts MCP servers may use Loading Not saved

        Empty: any public https host. When set, hosted servers and tool URLs must match, e.g. api.githubcopilot.com, *.example.com (wildcards match public hosts only). An internal server must be listed exactly; tool URLs can never be internal.

        Hosts providers may use Loading Not saved

        Only for an internal provider (e.g. Ollama) or sign-in server (OAuth, SSO) on your network, listed exactly, e.g. localhost. Public https needs no listing; separate from the MCP list.

        Data residency Loading Not saved

        Only providers in the ticked regions are used. None ticked: any.

        The policy YAML also requires (routing.require_data_residency); a provider must meet both.

        Regions providers may be in

        Danger area

        All traffic Loading

        Pausing refuses every chat request with HTTP 503 until traffic is resumed.

        Routing rules

        Send matching requests to a model you choose, ahead of auto-routing. Key rules come first, then member, then organization.

        Applies toWhenSends toPriorityMatchedActions

        Policy

        Cost cap, routing and privacy, as a form or YAML (one policy, saved together). Once this month's spend plus in-flight requests reach the cap, requests get HTTP 402.

        Current month spend
        $0.00
        $
        At the cap, paid requests are refused. $0 refuses all of them.

        Records which model the other routing engine would have picked, for Reliability's Routing engine card. Not shadow evaluation.

        The small model asked for a tier when routing is unsure (while the gateway's judge is on). Its cost counts toward the cap.

        Inactive: the gateway's judge is off (ROUTING_JUDGE=off), so this choice is saved but not used.

        How close a prompt must be to a cached one to reuse its answer, 0.80 to 1.00. Higher: fewer, safer hits. Empty: 0.90.

        The model "Saved by routing" prices each request at. Saved as routing.savings_baseline in the YAML.

        Inactive: savings are off on this gateway (ROUTING_SAVINGS_BASELINE=off), so this choice is saved but not used.

        Cost weight (Off, 0)

        How strongly cost affects routing. Balanced (5) is recommended.

        Exact value

        The same policy as YAML. An edit here shows in the form, and the other way round.

        Read-only: changing the policy requires the owner or admin role.

        Policy changes not saved yet

        Shadow evaluation

        Re-ask a sample of answered requests one tier down (or up) and let a judge model compare the answers. Results are under Spend & savings > Savings.

        Shadow evaluation is off on this server, so jobs record nothing. Set SHADOW_EVAL_ENABLED=1 and restart the gateway to use it.

        JobJudgeSpendStatusActions
        Observe · Spend & savings

        Spend & savings

        What the gateway spends, and what routing and the cache save.

        Only your API keys' spend this month.

        Spend by API key, this month

        Since the 1st (UTC), the window each key's budget is enforced in. Console requests have no key.

        KeyRequestsTokensSpendBudget
        Spend, last 30 days

        –

        Spend, all time

        –

        Cache hit rate

        –

        Tokens saved

        –

        By prompt optimization and cache

        Where spend goes

        Last 30 days
        By model
        30 days

          Spend by model, last 30 days
          ModelSpendShare

          No spend in the last 30 days.

          By provider
          By application
          By task

          Spend by model

          All time.

          ModelRequestsSpend

          Saved by routing, last 30 days

          –

          vs ·

          Would have cost

          –

          Every request on that model

          Charged

          –

          By day
          By application
          By API key

          Savings opportunities

          Could save
          –a month
          Loading…

          Costliest prompts

          Requests sent to a chosen model where a cheaper one would have done. Open one for details.

          Avoidable
          PromptTaskModel used → cheaperAvoidable

          Shadow evaluation

          Would a cheaper (or stronger) tier have done as well? A judge compares sampled answers; set jobs up under Guardrails & policy.

          Loading…

          Response cache

          Answers kept to serve a repeated prompt, exact and semantic.

          Loading…

          Observe · Reliability

          Reliability

          Provider health, single-provider risk and the routing engine.

          The outage simulator is off on this server. Set RESILIENCE_SIMULATION_ENABLED=1 and restart the gateway to use it.

          Provider reliability

          Every provider tried, failed tries included.

          Last 7 days
          Provider · modelAnsweredFailuresCut offMedian time

          Held back now

          Provider · modelWhyTime leftActions
          Learning from results

          Provider dependency

          How much traffic rests on one provider, and what an outage would hit.

          Share of traffic

          Loading…

          Applications on one provider

          Loading…

          If the top provider goes down

          Loading…

          Routing engine

          Whether your traffic supports switching to routing v2. Each check needs 50 requests.

          live engine … engine comparison …
          CheckStateWhat the traffic shows
          Observe · Requests

          Requests

          The last 50 requests, kept up to 7 days. Every request is in the Full log.

          Only requests made with your API keys.

          Searches the live feed only. The Full log has every request.
          Select a request to see its details.

          Full log

          Every answered request, from the database.

          WhenModelTokensCostLatencyTask ID

          Refused requests

          Requests turned down by a spend cap or key budget, a model rule, data residency, no provider, the context window, or a pause. Rate-limited ones are counted, not listed.

          WhenReasonWhat the caller was toldTask ID

          Agent tasks

          One row per agent task: the requests and tool calls tagged with the same X-Trace-Id.

           
          Task IDAI requestsTool callsCostLast activityActions
          Govern · Members

          Members

          Who can sign in, and with which role. Invite with a one-time link; change a role or remove someone at any time.

          People

           

          Owners manage everything. Admins manage everything except owners. Developers also create their own API keys. Viewers use the Playground and read.

          EmailRoleJoinedActions

          Removing someone signs them out and deletes their keys; their activity stays in the logs.

          Invitations

           
          EmailRoleStatusActions

          A link works once and expires after 7 days.

          Single sign-on

           

          Loading…

          Redirect URI to register with the provider
          Govern · Compliance

          Compliance

          Evidence for auditors, residency refusals and erasing prompts.

          Evidence pack

          Routing decisions, tool calls, the audit trail and residency refusals for the days chosen, as one hash chain. Check it with scripts/verify_evidence_pack.py.

          Residency refusals

          Requests refused because no provider was in a required region, each with a signed receipt.

          WhenWhoRequiredReceipt

          Erase prompts

          Removes the stored prompt text from the requests named. Their cost and usage stay, and the audit log records the erasure.

          Settings

          Settings

          Your account.

          Account

          Email–
          Role–
          Organization–
          Signs in with–
          SessionLasts up to 12 hours; reloading keeps you signed in

          Password

          At least 12 characters. Changing it signs you out everywhere else.

          Two-step verification

           

          After your password, a 6-digit code from an authenticator app (Google or Microsoft Authenticator, 1Password and others).

          Auto-routing

          Routing features this gateway runs. Set in the gateway's .env; read-only here.

           

          New key

          Create an API key

          For your reference. Shown in the key list and the audit log.
          Models
          $
          On top of the org's monthly cap.
          You can revoke it any time.
          For this key alone, on top of the org's limit. Empty: no key limit.

          Keyboard shortcuts

          Routing rule

          Add a rule

          Lower runs first, within the same scope.
          Send to
          With more than one, requests split by weight (90 and 10 sends about one in ten to the second).
          If it fails, try
          In this order. A first-token timeout (streams only) gives up on a slow model early; the last one always waits the usual time.
          Only when (all optional)
          %
          $
          Complexity is the classifier's 1–10. The cost is the request's estimate on the rule's model. The region is the policy's required residency; the classification is the request's data_classification. A request without the value (no header, no budget set) never matches.
          Shadow evaluation

          New job

          Percent of answered requests.
          It sees the request and both answers, so it follows the same policy and residency rules as the request.
          Shadow and judge calls together. The job stops before it would pass this.
          Members

          Invite someone

          They choose their own password from the link.
          Role
          Remove member

           

          They're signed out at once and their OAuth connections are deleted. Their activity stays in the logs. Invite them again to bring them back.

          A moved key keeps its secret, so applications using it keep working, and from then on it acts as its new holder, with their role.

          Invitation created

           

          Invitation link
          Residency refusal

          Signed receipt

           

          
                  
          Stored request

           

          Agent task

           

          Settings

          Two-step verification

           

          Or enter this key
          Open in an authenticator app on this device
           
          Recovery codes
          
                              
                          
          Members

          Set up single sign-on

          First register this redirect URI with the provider:

          The sign-in screen shows “Sign in with” and this.
          RouterX reads its settings from /.well-known/openid-configuration there.
          Stored encrypted and never shown again.
          Separate with commas. Leave empty to accept any address a member already has.
          Who may sign in
          Never as owner: invite an owner instead.
          Passwords stop working except for owners (in case the provider is down). People signed in stay signed in.
          API keys

          Rotate this key?

          The key gets a new secret, shown once. Its name, models, budget and history stay.

          Time to give your applications the new secret. Rotating again before then stops the old one.
          Costliest prompts

          Prompt details

          
                  

          Save your key

          Copy it now. It won't be shown again.

           
          Providers

          Add a provider

          Provider
          A provider at needs that address allowed.
          Where this provider keeps your data. Used only when data residency is enforced; Not set never counts as inside a region.
          Backup only is tried after the others.
          Models
          Everyday
          Tools (MCP, coding, agents)
          Reasoning (used only when routing has three tiers)

          ModelWorksToolsPrice / M
          RouterX tries likely models, cheapest first, and keeps the first that works. Change lists every model this key can use. A model with no known price needs one (or Free) so spend caps count it.
          MCP servers

          Add an MCP server

          How people refer to it: type @ and this name in the Playground.
          Runs as
          Must be https. An internal server (private address or http) needs its host listed exactly under Hosts MCP servers may use, in Guardrails & policy.
          Acts as
          People connect to it under My OAuth connections, below the server list. Each person's token is sent to this server as its Authorization header, so leave Authorization out of Request headers.
          The variable the server reads its token from (see its docs). RouterX sets it to the person's token each time it starts the server for them.
          Saved secrets show as ********. Leave one as it is to keep it, or type a new value to replace it.
          The SQL guardrail parses queries the way this database will. Readable tables are set for the organization under Guardrails & policy.
          For databases and APIs over the network. The server can then reach whatever the gateway can, RouterX's own database and Redis included: only for servers you trust.
          Tools to offer

          Every tool, including ones the server adds later. Run Test connection to choose fewer.

          Fewer tools mean smaller requests and an AI that can do only what you picked.

          Tool changes waiting for approval

          The server changed or added these tools since they were approved. Until you approve them, the model isn't offered them and calls are refused. The text below comes from the server: read it as you would a stranger's email.

          OAuth providers

          Add an OAuth provider

          Register this exact URI in the provider's app settings.
          RouterX sends the client secret here. Both endpoints must be public https, unless the host is listed exactly under Hosts providers may use in Guardrails & policy, for a sign-in server on your own network.

          Traffic replay simulator

          Running simulation on historical traffic…
          Requests analyzed
          0
          Current spend
          $0.00
          Projected spend
          $0.00
          Savings
          $0.00 (0%)

          Projected provider distribution

          Resilience simulator

          Take providers down and replay up to 100 requests from the last 30 days to see what the gateway would do. No real calls: it uses the mock provider.

          The outage simulator is off on this server. Set RESILIENCE_SIMULATION_ENABLED=1 and restart the gateway to use it.

          Providers to take down
          Running resilience simulation…
          Requests tested
          0
          Success rate
          0%
          Fallback rate
          0%
          Lost requests
          0
          Recovery latency
          —