Jev Decision MCP server

Jev Decision MCP

A local stdio MCP server exposing one tool, jevdecide**, for typed decisions through the official TypeSafe API. Written in TypeScript with the official MCP and TypeSafe SDKs.

Independent community project; not affiliated with TypeSafe. Licensed under MIT.

Batch independent questions over the same context in one call. Answers retain their question IDs. The MCP returns judgments and token usage; the caller owns thresholds, escalation, and action execution.

Install from npm

Requires Node.js 22 or newer. The published package runs without cloning or building:

npx -y jev-decision-mcp@0.1.2

Set TYPESAFEAPIKEY in your MCP host's environment. For hosts that use mcpServers JSON configuration:

{
  "mcpServers": {
    "jev": {
      "command": "npx",
      "args": ["-y", "jev-decision-mcp@0.1.2"]
    }
  }
}

Node.js and npm must be installed and available on the host's PATH. If the host cannot resolve npx, use its platform-specific launcher or absolute path as documented by that host. GUI applications may have a different PATH from your terminal.

The server communicates over stdio; starting it in a terminal waits for an MCP client rather than opening a web page. The npm installation does not read a .env from the caller's working directory.

Package: jev-decision-mcp on npm.

Connect to Codex

For the npm package, merge this into your Codex config.toml:

[mcp_servers.jev]
command = "npx"
args = ["-y", "jev-decision-mcp@0.1.2"]
env_vars = ["TYPESAFE_API_KEY"]
tool_timeout_sec = 45

Set TYPESAFEAPIKEY in the environment that launches Codex; envvars forwards its existing value to the server. Keep the host tool timeout above JEVTIMEOUT_MS / 1000. See official Codex MCP configuration.

Setup from source

Requires Node.js 22 or newer.

git clone https://github.com/amidabuddha/jev-decision-mcp.git
cd jev-decision-mcp
npm ci
# Copy .env.example to .env and set TYPESAFE_API_KEY.
npm run build

Obtain the key from TypeSafe Console. Use an official TypeSafe key, rather than an OpenRouter or third-party gateway key.

.env is excluded by .gitignore. The server reads the .env beside this README even when started from another working directory. Existing process environment variables take precedence. Restart the MCP server after editing .env.

The server starts without a key so a host can discover the tool. Calls then return MISSINGAPIKEY. API traffic is fixed to https://api.typesafe.ai/v1/systemone; TYPESAFEBASEURL does not override it. State and questions are sent to TypeSafe and may incur API charges. The server does not persist inputs or decisions and disables SDK logging. Upstream error bodies are not exposed because they may echo submitted data.

Connect a local source build

Shortened. The full README is on GitHub.