Skip to content
MCP server

typeprobe

TypeScript inferred types, completions and errors for AI coding agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
4.0.0
Listing updated
1 day ago

About typeprobe

typeprobe is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Agents often guess at what the TypeScript compiler infers, or write annotations by hand. This server asks the compiler directly and returns the answer. The README's example has an agent call hover_by_name on a file and a variable name and get back the type, such as string[], or run diagnostics on a file after an edit.

The same package includes a testing helper, typeprobe/testing, that returns inferred types as strings so you can lock them in snapshot tests with Vitest, Jest or Bun, plus a CLI and a synchronous library API. The project was called prinfer until version 4.0.0.

Backends are configurable. The default hover and diagnostics backend is TypeScript 7, with TypeScript 6 as a fallback, and you can use the bundled compilers or the project's own (TypeScript 5.0 to 6.x, or 7). A setup command registers the server for Claude Code, Codex, Cursor, VS Code or Gemini CLI, and can add a usage block to AGENTS.md.

Install

Run in a terminal

claude mcp add typeprobe -- npx -y typeprobe

Add to claude_desktop_config.json

{
  "mcpServers": {
    "typeprobe": {
      "command": "npx",
      "args": [
        "-y",
        "typeprobe"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "typeprobe": {
      "command": "npx",
      "args": [
        "-y",
        "typeprobe"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "typeprobe": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "typeprobe"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "typeprobe": {
      "command": "npx",
      "args": [
        "-y",
        "typeprobe"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "typeprobe": {
      "command": "npx",
      "args": [
        "-y",
        "typeprobe"
      ]
    }
  }
}

Configuration

  • TYPEPROBE_BACKENDBackend for the hover and diagnostics tools. Use typescript6 if the native TypeScript 7 backend fails in your project.
  • TYPEPROBE_COMPILERWhich TypeScript compilers to use: typeprobe's bundled ones, the project's own (typescript 5.0 to 6.x; typescript 7 or @typescript/native-preview), or auto: the project's when supported, else bundled.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

hover_by_name
Returns the inferred type for a named symbol in a file.
diagnostics
Returns type errors for a file.

What it does

Inferred type lookup
hover_by_name returns the type the compiler infers for a named symbol.
Post-edit diagnostics
diagnostics reports type errors for a file after a change.
Completions
Exposes compiler completions to the agent.
Snapshot testing helper
inferredType returns types as strings for snapshot tests.
Compiler selection
Use bundled compilers, the project's own, or auto.
One-line setup
npx setup commands register it with five agent clients.

Good for

  • Let an agent confirm a variable's real type before editing
  • Check type errors right after an agent change
  • Lock an API's inferred types in Vitest or Jest snapshots
  • Catch refactors that silently change a return type

Pricing

Open source

Open source npm package

Prices change. Check clockblocker.github.io before you buy.

typeprobe FAQ

How do I install it?

Run npx -y typeprobe setup with claude, codex, cursor, vscode or gemini; nothing needs installing first.

What was it called before?

prinfer, until version 4.0.0.

Which TypeScript versions does it support?

Its bundled compilers by default, or the project's own TypeScript 5.0 to 6.x or 7.

What if the TypeScript 7 backend fails?

Set TYPEPROBE_BACKEND to typescript6.

Is typeprobe free?

Yes. typeprobe is open source, so you can use and self-host it for free.

How do I add typeprobe to Claude Code?

Run this command in your terminal: claude mcp add typeprobe -- npx -y typeprobe

What are the best alternatives to typeprobe?

The closest alternatives to typeprobe are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to typeprobe

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools