/ Directory / Playground / MCP Inspector
● Official modelcontextprotocol ⚡ Instant

MCP Inspector

by modelcontextprotocol · modelcontextprotocol/inspector

The official debugger for MCP servers — connect to any server, call its tools live, see the raw protocol traffic.

MCP Inspector is the canonical dev tool for MCP. Point it at a server (local or remote), enumerate tools and resources, fire calls with structured inputs, and watch frames go by. First thing to reach for when your server misbehaves.

Why use it

Key features

Live Demo

What it looks like in practice

ready

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-inspector",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-inspector": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/inspector"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add mcp-inspector -- npx -y @modelcontextprotocol/inspector

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use MCP Inspector

Debug your MCP server without involving an LLM

👤 Developers ⏱ ~15 min intermediate

When to use: Claude says 'tool failed' and you need to see what really happened.

Flow
  1. Launch
    npx @modelcontextprotocol/inspector ./my-server.✓ Copied
    → UI opens
  2. Invoke
    Pick the tool; fill inputs; send.✓ Copied
    → Result + frames shown
  3. Diagnose
    Toggle raw frames to see protocol-level errors.✓ Copied
    → Root cause clear

Outcome: Server bug isolated without LLM noise.

Combinations

Pair with other MCPs for X10 leverage

mcp-inspector + fastmcp-prefect

Build a FastMCP server; debug it with the Inspector before shipping

Combine mcp-inspector with fastmcp-prefect: Build a FastMCP server; debug it with the Inspector before shipping✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
tools.call (see docs) Invoke any tool the server advertises 1 call
resources.list (see docs) Browse resources 1 call

Cost & Limits

What this costs to run

API quota
N/A
Tokens per call
N/A
Monetary
Free OSS
Tip
Save common invocations as bookmarks

Security

Permissions, secrets, blast radius

Credential storage: Local only
Data egress: Whatever the server reaches
Never grant: Run untrusted MCP servers against your auth tokens

Troubleshooting

Common errors and fixes

Server won't connect

Check transport (stdio vs SSE); confirm the binary path

Alternatives

MCP Inspector vs others

AlternativeWhen to use it insteadTradeoff
mcp2cliYou prefer command-lineNo GUI for protocol inspection

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills

Continue exploring

Related tools and workflows

Choose another guide for your workflow, or explore a collection.

Explore more MCP guides

Docker Hub MCP

Search Docker Hub images and inspect repositories and tags with Docker’s own MCP integration.

MCP

Explore more MCP guides

Adyen MCP

Use Adyen’s alpha MCP server to inspect payment methods and sessions, create payment links, and work with merchant webhook configuration.

MCP

Explore more MCP guides

Permit.io Access Request MCP

Expose Permit.io access requests, operation approvals, and resource instances to an MCP-enabled assistant.

MCP

Browse all topic collections → · See 29 new official additions →