MCP Inspector
The official open-source visual tool for testing and debugging Model Context Protocol servers — connect, list, and call tools, resources, and prompts.
MCP Inspector is the official, open-source developer tool for testing and debugging Model Context Protocol servers. It's the fastest way to see what a server actually exposes: connect to it, browse its tools, resources, and prompts, call them with arbitrary inputs, and watch the raw request/response traffic — all from a local web UI, with no client and no model in the loop.
It is aimed at anyone building an MCP server who wants to confirm a capability behaves before wiring it into Claude Code or another client. Because it talks to your server directly, it separates "is my server correct?" from "is the model using it well?" — so you debug one problem at a time.
Highlights
- Connect to any MCP server — launch a local stdio server as a child process, or point it at a remote Streamable HTTP server by URL.
- Exercise every primitive — list and call tools with custom arguments, read resources, and render prompts, seeing typed inputs and results.
- See the wire — inspect the JSON-RPC messages, notifications, and errors flowing in both directions, which is where most server bugs reveal themselves.
- Zero install — run it on demand with
npx; it opens a browser UI against your server.
In an AI-assisted workflow
Point the Inspector at the server you're developing and click through its tools before any client touches it:
# launch the Inspector against a local stdio server
npx @modelcontextprotocol/inspector node ./my-server/index.jsIt opens a UI where you connect, list the server's tools, call one with sample inputs, and read back the result and any errors — the tight loop that catches a bad schema or a vague description early.
TIP
Debug in the Inspector first, then connect to a client. If a tool misbehaves in the Inspector, it's a server bug; if it works there but the model misuses it, it's a naming/description (routing) problem — see Building an MCP Server.
Good to know
MCP Inspector is free and open source under MIT and maintained as part of the Model Context Protocol project. You run it locally via Node.js (npx @modelcontextprotocol/inspector), and it's the standard first stop when building a server with a framework like FastMCP or the official SDKs.
Related
- Building an MCP ServerAn accurate introduction to the Model Context Protocol: server anatomy, transports, and connecting a tool to Claude Code.
- MCP Server EngineerUse this agent to build, harden, or productionize a Model Context Protocol (MCP) server — designing tools/resources/prompts, choosing stdio vs. Streamable HTTP, taking a server remote with OAuth and stateless scaling, and testing it with the MCP Inspector. Examples — "wrap our internal API as an MCP server with three tools", "take our stdio server remote so the team can share it", "our tools confuse the model — fix the names, schemas, and descriptions".
- Deploying a Remote MCP Server: Stateless, Streamable HTTP, and Horizontal ScalingTake an MCP server from local stdio to a remote, multi-user HTTP service — Streamable HTTP, stateless vs. stateful sessions, OAuth, and horizontal scaling.
- FastMCPA Pythonic framework for building Model Context Protocol servers and clients — decorator-based tools, resources, and prompts, with auth and deployment built in.
- MCP Server ScaffolderScaffold a new Model Context Protocol (MCP) server from a description — pick the SDK and transport, generate a typed first tool with a strict schema, and wire up MCP Inspector testing and the client-registration command. Use when starting a new MCP server and you want a correct, runnable skeleton instead of copying a README.
- Add MCP ServerAdd an MCP server to the current project the safe way — pick the transport and scope, wire secrets through env vars, vet provenance, and verify the connection before trusting it.
- Connecting and Governing MCP Servers: Registries, Gateways, and Tool SprawlAs MCP servers multiply, discovery, trust, and tool sprawl become the problem. How registries, gateways, and curation keep a growing fleet secure and usable.
- SmitheryA registry and hosting platform for Model Context Protocol servers — discover, deploy, and connect MCP servers from one place.