Can I use my TypeSafe API key with this MCP server?

No. The gateway is built for an OpenRouter key and the ~typesafe/jev-latest alias on OpenRouter's alpha decisions endpoint; the README says native TypeSafe keys and SDK routing are not supported.

How do I add the server to Claude Code or Cursor?

Add it as a stdio MCP server. For example, `claude mcp add --scope user openrouter-jev-mcp -e OPENROUTER_API_KEY=... -- uvx --from git+https://github.com/ctmx/openrouter-jev-mcp openrouter-jev-mcp`; Cursor and Codex config snippets are in the README.

What does the jev_health tool actually verify?

It reports local configuration readiness plus the configured model and connectivity status, but connectivity is unverified unless you pass verify=true. Tool discovery alone does not confirm provider connectivity.

What happens when a request keeps failing?

Transient HTTP codes 408, 429, 502, 503 and 504, connection errors and transport timeouts get up to three attempts with exponential backoff starting at 0.25 seconds. A 20-second network deadline covers attempts and backoff, and at most eight requests may be in flight per instance.

Where do the diagnostics logs go and how long are they kept?

Successful calls log state and answers by default to $JEV_LOG_DIR or ~/.local/state/jev-gateway, with owner-only permissions, a 20 MiB aggregate cap and 24-hour retention. The README notes secret filtering is best effort and cannot detect every sensitive value.

Can I keep a field out of the diagnostic log?

Yes, with RFC 6901 pointers such as logging_exclusions=["/state/customer"], but those omit the field only from the diagnostic copy. They do not remove it from the state actually sent to OpenRouter, so the request itself still carries it.

How do I use the gateway from Python instead of MCP?

Import JevGateway and call jev.check, jev.choice and the other primitives directly. Set OPENROUTER_API_KEY first; calls can raise JevGatewayError, which you should handle as an unavailable judgement rather than a false verdict.

CommunityJev Agents & MCP

Openrouter Jev MCP

A Python decision gateway and stdio MCP server that exposes Jev through OpenRouter's alpha decisions endpoint. Five tools cover yes/no checks, classification, scoring, multi-question evaluation and health, with bounded retries, validated answers and local diagnostics.

See highlights

Open github.com

Stars: 3
Language: Python
License: MIT
Published by: Community
Last verified: Oct 2026

ctmx/openrouter-jev-mcp

User repository on GitHub

View on GitHub

High-speed System One Jev AI decision gateway and MCP server powered by OpenRouter

Forks: 1
Last pushed: Updated Sep 2026

Repo stats from the GitHub API, cached Oct 2026.

About this project

An independent community project, unaffiliated with TypeSafe or OpenRouter. The supported environment is Linux with Python 3.13; Windows is unsupported because diagnostic locking uses POSIX facilities. Coding agents repeatedly encounter small, bounded questions that can benefit from a separate model judgement:

Quoted from the project's README. Read the full README.

Tagscommunity mcp openrouter gateway

Works forJev for Classification Jev for Scoring Jev for Verification

Used inJev for Software & DevTools

Languages: Python
Platforms: MCP OpenRouter
Capabilities: Open sourceSelf-hostedRequires API key

Highlights

Five MCP tools: jev_check (noul), jev_classify (choice), jev_score, jev_evaluate for multi-question batches and jev_health diagnostics.
Uses an OpenRouter key on the alpha decisions endpoint with the ~typesafe/jev-latest alias; native TypeSafe keys are not supported.
Bounded retries of up to three attempts on transient HTTP codes with exponential backoff from 0.25 s and a 20-second deadline.
Malformed JSON, missing answers and invalid values produce structured errors; failures are treated as no judgement.
Local diagnostics log to ~/.local/state/jev-gateway with owner-only permissions, a 20 MiB cap and 24-hour retention.

Watch out

MIT-licensed community project unaffiliated with TypeSafe or OpenRouter. It depends on an alpha OpenRouter endpoint whose availability and contract may change, and Linux with Python 3.13 is the supported environment.

Questions about this entry

Short answers drawn from the linked project or page.

Reactions & coverage

Posts, threads, and videos about this entry from around the web.

Hacker News: Show HN: Agent Chaperone screens tool calls and results with Jev before the agent sees them.

sepehrsafari5 pointsShow HN: Agent Chaperone – Screen AI agent tool calls and results with JevRead the thread on Hacker News

X: Jev lands on the Vercel AI Gateway

X: Jev as an LLM guardrail inside Agentgateway

X: jev-review: a local-first score loop for coding agents

Related terms

Glossary definitions related to this entry.

More Jev resources like this

jev-code

Five typed tools — classify, check, score, rank, and ask — plus a skill, wired into Claude Code, Codex, Pi, and OpenCode in one setup command.

Jev Agents & MCP#community#typescript#mcp

Community

FrancoisChastel/jev-codeTypeScript

AgentScope

33k

Alibaba's multi-agent platform, which implements native TypeSafe Jev classification through JevClassifierModel for binary, choice and score routing across agent pipelines. Python 3.11+, Apache-2.0, with a FastAPI agent service and web UI.

Jev Integrations & Adapters#community#multi-agent#framework

Community

agentscope-ai/agentscopePython

System One Connector

349

A single-binary MCP tool named evaluate that sends Noul, Choice, and Score questions to hosted Jev or a local System One server.

Jev Agents & MCP#community#go#mcp

Community

itsmostafa/system-one-connectorGo

ruling

A local Jev-compatible server that reads Choice, Score and Noul answers from the logits of any MLX checkpoint or OpenAI-compatible endpoint with no training, serving POST /v1/systemone as a drop-in for the official TypeSafe SDK.

Jev Models & Reimplementations#community#mlx#calibration

Community

bradAGI/rulingPython

sortwell

MCP server and Claude Code plugin that files each captured note, link or meeting line with one Jev request: kind, project, action and duplicate questions answered in parallel. Routes to a project only at 0.45 or above, marks a duplicate only at 0.70 with a matching item, and stores text verbatim in append-only JSONL.

Jev Agents & MCP#community#mcp#note-taking

Community

dharun-cohere/jev-sortwellTypeScript

Ollaya

1.3k

A local daemon that pulls open decision models and serves them on TypeSafe's /v1/systemone, so a Jev client switches hosts with TYPESAFE_BASE_URL.

Jev Models & Reimplementations#community#rust#open-models

Community

ollaya-dev/ollayaRust

From the Jev guides

Original write-ups on what this entry is for.

Jev on the Gateways: Vercel, Workers AI, and OpenRouter

Oct 12, 2026

The request shape barely changes across surfaces; the surrounding contract does. When to call the API directly and when a gateway, a Worker binding, or a router entry earns its extra hop.

Jev Tools & CLIs#gateway#vercel#cloudflare

Read article

Back to all resources

From the Jev community

Posts from builders shipping with Jev right now.

Follow @typesafeai