---
title: MCP server (TypeScript, stdio)
surface: mcp-typescript
canonical: https://inferior.ai/docs/mcp-typescript.html
package: "@inferior-ai/mcp"
schema_version: 2.0.0
---

# Inferior MCP server — TypeScript (stdio)

Local-subprocess MCP server, Node-native. Same 18 tools, 4 resources, 5 prompts as the Python MCP — see [Python MCP → Tools/Resources/Prompts](/docs/mcp-python.md#tools-18) for the authoritative reference. The two `verify_*` tools are documented at [Verify Action API](/docs/verify-action.md).

## Install

```bash
npm install -g @inferior-ai/mcp@beta
# or, no install:
npx @inferior-ai/mcp
```

Node 18+. Configure in your host's MCP config:

```json
{
  "mcpServers": {
    "inferior": {
      "command": "npx",
      "args": ["@inferior-ai/mcp"],
      "env": { "INFERIOR_API_KEY": "cw_full_..." }
    }
  }
}
```

## Live manifest

Identical fetch behaviour to the Python MCP: `GET /v1/mcp/manifest.json` at boot via `fetch()` with a 3 s `AbortController`. Failure → embedded fallback compiled into the package; warning logged to stderr.

## Response shape

Tool output is rendered text built from the v2.0 REST response shapes — see [REST → Response structures](/docs/rest-api.md#response-structures). The TypeScript MCP exposes nothing the REST API doesn't.

## See also

- [Verify Action API](/docs/verify-action.md) — `verifyActionInferior` / `verifyOutcomeInferior` reference + response shapes
- [Python MCP](/docs/mcp-python.md) — authoritative per-tool / per-resource / per-prompt reference
- [Streamable HTTP MCP](/docs/mcp-http.md) — zero-install hosted variant
- [Codex plugin](/docs/codex-plugin.md), [Gemini extension](/docs/gemini-extension.md) — hosts that consume this MCP