What is jev-mcp and why does it exist?

It is a minimal MCP server that exposes Jev to agents so you get decisions your code can consume: classify, route, measure, verify. The README points out TypeSafe documents the API but publishes no official MCP server, so this repository is the local piece that joins the two.

Which agents can use it?

Any MCP client, with documented paths for Claude Code, Codex, Cursor, and Hermes, plus agents launched from Orca. For Claude Code the README shows claude mcp add jev --scope user with run.sh; other clients take a standard mcpServers entry pointing at server.py.

What tools does the server expose?

ask_jev and list_jev_models. ask_jev takes a state plus typed questions and can return choice, score, or noul answers with probabilities and confidence where the shape provides it; list_jev_models reports what is available to call.

Why does the repository ship run.sh and a .env file?

The README says several third-party Jev MCPs hit the same failure: some MCP clients filter environment variables when starting a server, so the key silently disappears and every call fails. run.sh reads the key from jev-mcp/.env instead, so it does not depend on each client's environment.

What does it need to run?

No dependency install: it is one file that uses the Python standard library, launched by your MCP client rather than by you. Live calls need a TYPESAFE_API_KEY from console.typesafe.ai/keys; the README does not publish pricing for those calls.

How do I check the server works?

Run bash smoke_test.sh, which performs a handshake, a tools/list request, and one real call. After registering it, claude mcp list should show jev as connected if the key and path are set up correctly.

What are the limits of this project?

It is an unofficial community bridge: TypeSafe publishes SDKs and an agent skill, not an MCP server. Real calls need network access and a valid key, the server is local stdio only, and the README is in Spanish and was truncated in the digest, so some client setup details were not visible to us.

Jev directory

CommunityJev Agents & MCP

jev-mcp (CodeIA Academy)

A dependency-free MCP server that exposes TypeSafe's Jev to Claude Code, Codex, Cursor, Hermes, and other agents through the ask_jev and list_jev_models tools, so your code gets typed decisions with probabilities instead of prose to parse.

See highlights Open github.com

Stars: 3
Language: Python
License: MIT
Reading time: 3 min
Published by: Community
Author: codeia-academy
Last verified: Oct 2026

codeia-academy/jev-mcp

Organization repository on GitHub

View on GitHub

MCP local que expone Jev (TypeSafe) como herramienta para Claude Code, Codex, Hermes y cualquier agente: ask_jev y list_jev_models, sin dependencias

Forks: 0
Last pushed: Updated Oct 2026

Repo stats from the GitHub API, cached Oct 2026.

This is one of several Jev listings for the same project. The canonical entry is Jev MCP — jkudish.

Tagscommunity catalog-import logicrw mcp agents python

Works forJev for Classification Jev for Routing Jev for Scoring

Used inJev for Software & DevTools

Languages: Python
Platforms: MCP
Capabilities: Open sourceRuns locallyRequires API key

Highlights

Single-file Python server that uses only the standard library and speaks MCP over stdio when your client launches it.
Asks Jev through HTTPS with a Bearer TYPESAFE_API_KEY against api.typesafe.ai/v1/systemone and returns typed answers.
Supports Jev's answer shapes: choice with probabilities and confidence, score with a legend, and noul without confidence.
Mix all three question types in one call; they are evaluated in parallel and in isolation, so added questions cost only their tokens.
The run.sh wrapper reads the key from jev-mcp/.env because some MCP clients filter environment variables at startup.

Quickstart

bash

git clone https://github.com/CodeIA-Academy/jev-mcp.git
cd jev-mcp
cp .env.example .env
bash smoke_test.sh

Watch out

Grounded in the repository README (Spanish) and GitHub metadata reviewed on 2026-10-15; the README notes TypeSafe documents the API but publishes no official MCP server, prints no benchmark numbers, and its agent-registration section was truncated mid-sentence.

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.

X: Jev in front of the HeyGen MCP

X: Playwright CLI + Jev vs Playwright MCP

X: A local MCP server that cuts computer use from 23s to 0.8s. Cartwright built Cortex, a local MCP server where…

X: A side panel that drives any site's WebMCP tools

From the Jev guides

Original write-ups on what this entry is for.

MCP tool routing: Jev in front of the tool call

Oct 16, 2026

Tool menus can outgrow the context that reads them. The catalog's Jev-based routers and gates narrow the list: benchmarked tool search, per-tool scoring, fail-closed approvals, and WebMCP in the browser.

Jev Agents & MCP#mcp#tool-routing#agents

Read article

Putting Jev in the Coding Loop: MCP Servers, Gates, and Skills

Sep 14, 2026

The fastest-growing corner of the Jev ecosystem is coding agents. A tour of the MCP servers, tool-call gates, context pruners, and skill rankers built for that loop.

Jev Tools & CLIs#agents#mcp#coding-agent

Read article

Approval policies for coding agents: hooks, guards, and gateways

Oct 16, 2026

How the Jev guard family turns coding-agent permissions into auto-approve, deny, or ask: hooks that enforce, guards that fail safe, and gateways that gate generation.

Jev Agents & MCP#coding-agents#guardrails#hooks

Read article

From the Jev AI model community

Posts from builders shipping with Jev right now.

Follow @typesafeai

jev-mcp (CodeIA Academy)

Highlights

Quickstart

Questions about this entry

What is jev-mcp and why does it exist?

Which agents can use it?

What tools does the server expose?

Why does the repository ship run.sh and a .env file?

What does it need to run?

How do I check the server works?

What are the limits of this project?

Reactions & coverage

Related terms

More Jev resources like this

From the Jev guides

From the Jev AI model community