typesafe-mcp

# Typesafe MCP

**Give your AI agent typed decisions instead of free text.** `evaluate` is an MCP server that lets Claude Code, Claude Desktop, Codex, and [pi](https://pi.dev) call [TypeSafe](https://typesafe.ai)'s Jev model and get back probabilities they can branch on. One command, `evaluate setup mcp`, registers it with the first three (if detected); `evaluate setup pi` covers pi.

[](https://github.com/itsmostafa/typesafe-mcp/releases/latest)
[](LICENSE)


```
┌──────────────┐  evaluate   ┌──────────┐  POST /v1/systemone  ┌──────────────┐
│ Claude Code  │ ──────────▶ │ evaluate │ ───────────────────▶ │ TypeSafe API │
│ Claude Desk. │   (stdio)   │  (MCP)   │  retries 429 / 529   │  ── or ──    │
│ Codex        │             │          │                      │  OpenRouter  │
│ pi           │ ◀────────── │          │ ◀─────────────────── │              │
└──────────────┘ typed JSON  └──────────┘   POST /decisions    └──────────────┘
```

## Why this exists

**Problem:** When an agent needs a yes/no call, a routing decision, or a severity rating, it usually asks an LLM, then parses prose and hopes the format holds. The answer has no probability attached, so the agent cannot tell a confident "yes" from a coin flip.

**Solution:** `evaluate` exposes one tool, `evaluate`, that sends state plus typed questions to Jev and returns structured answers with probabilities. Nothing to parse and no prompt formatting to maintain. `evaluate setup mcp` wires it into Claude Desktop, Claude Code, and Codex in one step, and `evaluate setup pi` installs the equivalent extension for pi.

## Quickstart

**1. Install** (macOS and Linux, amd64 and arm64):

```sh
curl -fsSL https://raw.githubusercontent.com/itsmostafa/typesafe-mcp/main/install.sh | sh
```

It installs to `~/.local/bin`. If th