Skip to content

About

open-sourced jev-flash-router: an MCP server for TypeSafe's new Jev model. AI coding agents waste hundreds of reasoning tokens just deciding which file to edit, which route to pick, or whether a diff breaks tests. Jev evaluates state and outputs calibrated probabilities. Works with Cursor, Windsurf, & Claude Code

Resources

Contributing

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

jev-flash-router

npm version License: MIT Node.js MCP OpenRouter

Zero-token-output decision router MCP server powered by TypeSafe Jev.

AI coding agents waste hundreds of reasoning tokens just deciding which file to edit, which route to pick, or whether a diff breaks tests. jev-flash-router evaluates context, code diffs, logs, or planning options and returns calibrated probabilities in ~150ms — with $0.00 output token cost.


Features

  • ~150ms decisions — Lightning-fast evaluation via OpenRouter Decisions API
  • Zero output token cost — output_tokens: 0 on every call
  • TypeSafe Jev — Powered by the cutting-edge typesafe/jev-latest model
  • MCP-native — Works seamlessly with Cursor, Windsurf, Claude Desktop, and Claude Code
  • Zero-config — Run via npx or build locally from source
  • Three decision formats — noul (binary), choice (categorical), score (rubric)

Quick Start

1. Get an OpenRouter API Key

Obtain an API key from OpenRouter with access to the Jev model.

2. Client Setup

Option A: Run directly via npx (Recommended)

{
  "mcpServers": {
    "jev": {
      "command": "npx",
      "args": ["-y", "jev-flash-router"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-YOUR-ACTUAL-API-KEY"
      }
    }
  }
}

Option B: Run from Local Source (Cloned Repository)

{
  "mcpServers": {
    "jev": {
      "command": "node",
      "args": ["/path/to/jev-flash-router/dist/index.js"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-YOUR-ACTUAL-API-KEY"
      }
    }
  }
}

3. Install AI Agent Skill (Recommended)

To automatically configure your AI agent (Antigravity IDE, Cursor, Claude Code) with the Master Jev Skill so it proactively uses zero-token decisions:

npx -y jev-flash-router install-skill

Option C: GUI Client Setup (Manual Field Entry)

  • Server name: jev
  • Executable command: node (or npx)
  • Arguments: /path/to/jev-flash-router/dist/index.js (or -y\njev-flash-router)
  • Environment: OPENROUTER_API_KEY=sk-or-v1-YOUR-ACTUAL-API-KEY

MCP Client Configuration

Cursor

Go to Settings → Features → MCP Servers → Add New MCP Server:

{
  "mcpServers": {
    "jev": {
      "command": "node",
      "args": ["/path/to/jev-flash-router/dist/index.js"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-YOUR-ACTUAL-API-KEY"
      }
    }
  }
}

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "jev": {
      "command": "node",
      "args": ["/path/to/jev-flash-router/dist/index.js"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-YOUR-ACTUAL-API-KEY"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "jev": {
      "command": "node",
      "args": ["/path/to/jev-flash-router/dist/index.js"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-YOUR-ACTUAL-API-KEY"
      }
    }
  }
}

Installation for Developers

Clone and Run Locally

git clone [https://github.com/Ravinder82/jev-flash-router.git](https://github.com/Ravinder82/jev-flash-router.git)
cd jev-flash-router
npm install
npx tsc --types node && chmod +x dist/index.js

API Reference

Tool: evaluate_decision

Evaluates context and returns calibrated probabilities.

Parameter Type Required Description
state string Yes Context, code diff, error log, or task description
question string Yes Targeted question (e.g., "Will this change cause a breaking API error?")
type string Yes Decision format: "noul", "choice", or "score"
criteria object Yes Criteria map matching the chosen type

Criteria Examples

noul (binary yes/no):

{
  "true": "breaks existing callers",
  "false": "backward compatible"
}

choice (categorical):

{
  "option1": "use caching",
  "option2": "recompute",
  "option3": "defer"
}

score (ordered rubric):

[
  "critical",
  "warning",
  "info"
]

Cost and Performance

Metric Value
Latency ~150ms
Output tokens 0
Output cost $0.00
Input cost ~$0.042 / 1M tokens
Model typesafe/jev-latest

License

MIT

About

open-sourced jev-flash-router: an MCP server for TypeSafe's new Jev model. AI coding agents waste hundreds of reasoning tokens just deciding which file to edit, which route to pick, or whether a diff breaks tests. Jev evaluates state and outputs calibrated probabilities. Works with Cursor, Windsurf, & Claude Code

Resources

Contributing

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages