typeprobe
TypeScript inferred types, completions and errors for AI coding agents
- 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 typeprobeAdd to claude_desktop_config.json
{
"mcpServers": {
"typeprobe": {
"command": "npx",
"args": [
"-y",
"typeprobe"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"typeprobe": {
"command": "npx",
"args": [
"-y",
"typeprobe"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools