# typeprobe MCP server

> Provides TypeScript inferred types, completions, and type errors to AI coding agents via an MCP server.

- Repository: https://github.com/clockblocker/typeprobe
- Page: https://hostedmcp.org/servers/clockblocker/typeprobe
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 4.0.0

## Install

### Claude Code

```sh
claude mcp add typeprobe -- npx -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"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"typeprobe","type":"stdio","command":"npx","args":["-y","typeprobe"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

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

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.typeprobe]
command = "npx"
args = ["-y", "typeprobe"]
```

### Gemini CLI

```sh
gemini mcp add -s user typeprobe npx -- -y typeprobe
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `TYPEPROBE_BACKEND` | no | no | Backend for the hover and diagnostics tools. Use typescript6 if the native TypeScript 7 backend fails in your project. |
| `TYPEPROBE_COMPILER` | no | no | Which 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 (12)

- `hover_by_name`
- `hover`
- `batch_hover`
- `completions`
- `diagnostics`
- `annotations`
- `backend`
- `signature`
- `display`
- `kind`
- `cost`
- `compiler`

## FAQ

### What can typeprobe do for my AI agent?

It allows an agent to query the TypeScript compiler for inferred types, completions, and diagnostics so it doesn't have to guess.

### How do I install typeprobe for Claude Code?

You can add it using the plugin marketplace commands: /plugin marketplace add clockblocker/typeprobe and /plugin install typeprobe@typeprobe.