# typeprobe

> typeprobe is an open-source MCP server for developer tools. TypeScript inferred types, completions and errors for AI coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, vscode
- **Website:** https://clockblocker.github.io/typeprobe/
- **Repository:** https://github.com/clockblocker/typeprobe
- **MCP Registry name:** io.github.clockblocker/typeprobe
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add typeprobe -- npx -y typeprobe
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/typeprobe
