Spiral gives your agent every tool with one account. Browse the tools →

Windsurf · Developer

How to Use OpenRouter model usage statistics in Windsurf

Returns model usage and availability statistics from OpenRouter. Use it to assess observed adoption and service health alongside a model's published specifications.

Prompts to try with OpenRouter model usage statistics in Windsurf

Copy an example into Windsurf, or ask in your own words.

Use OpenRouter model usage statistics to look this up and give me the result as a table. Save the result in ./assets.

OpenRouter model usage statisticsWindsurf
Try asking
  • Pull the latest numbers from OpenRouter model usage statistics and tell me what changed since last week.

  • Check OpenRouter model usage statistics and summarize what you find in three bullet points.

  • Pull the newest data from OpenRouter model usage statistics and give me the result as a table.

  • Check OpenRouter model usage statistics every morning and tell me only when something changed.

How to set up OpenRouter model usage statistics in Windsurf

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run OpenRouter model usage statistics

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "alexandria",
        "model": "openrouter-ai/model-marketplace/get_model_stats",
        "input": {
          "permaslug": "<permaslug>"
        }
      }'

Then paste one of the prompts above: Windsurf finds OpenRouter model usage statistics on Spiral, shows the price and runs it.

OpenRouter model usage statistics providers and prices

Spiral runs OpenRouter model usage statistics through Alexandria. Open a card for today's price, with every fee included.

AlexandriaDeveloper
OpenRouter · Get model stats
openrouter-ai/model-marketplace/get_model_stats

What can you do with OpenRouter model usage statistics in Windsurf?

Build a model selection report around the requirements in your project. An agent can compare OpenRouter catalog evidence with your document sizes and output needs, then identify candidates for testing.

Choose a model for document summaries

Find candidates, compare their context windows and output capabilities, inspect serving limits, and review usage statistics before selecting models for a document-summary evaluation.

Investigate slow model responses

Compare serving endpoint measurements and model statistics, review the latency definitions, and consult the provider directory to identify the organizations behind the serving endpoints.

Maintain an internal model comparison

Refresh a shortlist with published specifications, pricing data, usage statistics, and serving endpoint measurements. Use the documentation to keep metric definitions consistent.

Plan an evaluation within one author's catalog

List an author's models, compare their published specifications, inspect pricing data and observed usage, and check serving endpoint limits to choose candidates for testing.

Write a model selection brief

Combine catalog search, an author's listed models, pricing data, usage statistics, provider policies, and documentation into a source-based brief for a product team.

Questions about OpenRouter model usage statistics in Windsurf

Can Windsurf use OpenRouter model usage statistics?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run OpenRouter model usage statistics like any built-in tool.

How much does OpenRouter model usage statistics cost in Windsurf?

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

Do I need an Alexandria account to use OpenRouter model usage statistics in Windsurf?

No. Spiral runs OpenRouter model usage statistics on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up OpenRouter model usage statistics in Windsurf?

About two minutes: add the server, then sign in, then check it.

Does Windsurf wait while OpenRouter model usage statistics runs?

OpenRouter model usage statistics runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

Does OpenRouter's default model list cover every output type?

The documented default list covers text generation. OpenRouter also documents a broader listing across all modalities, including image, video, text, and speech.

How quickly does OpenRouter update model information?

OpenRouter says it publishes model information as soon as it confirms it. That statement does not establish a fixed hourly or daily refresh schedule.

What time period do performance measurements cover?

The routing guide describes rolling five-minute percentiles, while the endpoint response schema defines latency percentiles over 30 minutes. These are different measurement windows, so comparisons need to use the same window.

Does the context window apply only to the input?

Input and output share the context window. A long input therefore reduces the space available for the response, even when the model lists a larger maximum output ceiling.

Are OpenRouter's coding and agentic benchmark fields still populated?

The current schema says Artificial Analysis retired its Coding Index and Agentic Index. Both fields are null for every model.

Get started

Start using OpenRouter model usage statistics in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options