MCPJam

inspector

Built by MCPJam β€’ 1,827 stars

What is inspector?

Test & Debug MCP servers, ChatGPT apps, and MCP Apps (ext-apps)

How to use inspector?

1. Install a compatible MCP client (like Claude Desktop). 2. Open your configuration settings. 3. Add inspector using the following command: npx @modelcontextprotocol/inspector 4. Restart the client and verify the new tools are active.
πŸ›‘οΈ Scoped (Restricted)
npx @modelcontextprotocol/inspector --scope restricted
πŸ”“ Unrestricted Access
npx @modelcontextprotocol/inspector

Key Features

Native MCP Protocol Support
Real-time Tool Activation & Execution
Verified High-performance Implementation
Secure Resource & Context Handling

Optimized Use Cases

Extending AI models with custom local capabilities
Automating system workflows via natural language
Connecting external data sources to LLM context windows

inspector FAQ

Q

Is inspector safe?

Yes, inspector follows the standardized Model Context Protocol security patterns and only executes tools with explicit user-granted permissions.

Q

Is inspector up to date?

inspector is currently active in the registry with 1,827 stars on GitHub, indicating its reliability and community support.

Q

Are there any limits for inspector?

Usage limits depend on the specific implementation of the MCP server and your system resources. Refer to the official documentation below for technical details.

Official Documentation

View on GitHub
<div align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./mcpjam-inspector/client/public/mcp_jam_dark.png"> <source media="(prefers-color-scheme: light)" srcset="./mcpjam-inspector/client/public/mcp_jam_light.png"> <img width="250" alt="MCPJam Inspector V1 logo" src="./mcpjam-inspector/client/public/mcp_jam_light.png"> </picture> <br/>

www.mcpjam.com

npm version License: Apache 2.0 Discord

</div>

MCPJam Inspector is the local development client for ChatGPT apps, MCP ext-apps, and MCP servers. Build and test your apps with a full widget emulator, chat with any LLM, and inspect your server’s tools, resources, prompts, and OAuth flows.

No more ngrok or ChatGPT subscription needed. MCPJam is the fastest way to iterate on any MCP project.

πŸš€ Quick Start

Start up the MCPJam inspector:

npx @mcpjam/inspector@latest
<img alt="MCPJam Inspector Demo" src="./docs/images/mcpjam-banner.png">

Table of contents

Installation Guides

Requirements

Node.js TypeScript

Install MCPJam

We recommend starting MCPJam inspector via npx:

npx @mcpjam/inspector@latest

We have a Mac and Windows desktop app:

Run MCPJam using Docker:

docker run -p 6274:6274 mcpjam/mcp-inspector

Key features

CapabilityDescription
ChatGPT Apps SDKLocal development for ChatGPT Apps SDK support. Full support for the windows.openai API: widgetState, callTool, structuredContent, sendFollowUpMessage, displayMode, CSP, and more. No more ngrok or ChatGPT subscription needed. Read more
MCP ext-apps (Claude)Full local development for MCP Apps (SEP-1865). Support for all JSON-RPC message types, such as tools/call, ui/initialize, ui/message, ui/open-link, and more. Read more
OAuth DebuggerDebug your MCP server's OAuth implementation at every step. Visually inspect every network message. Supports all protocol versions (03-26, 06-18, and 11-25). Support for client pre-registration, DCR, and CIMD. Read more
LLM playgroundChat with your MCP server against any LLM in the playground. We provide frontier models such as GPT-5 and Claude Sonnet for free, or bring your own API key. Playground supports ChatGPT apps and MCP Apps. Read more
MCP server debuggingConnect to and test any MCP server local or remote. Manually invoke MCP tools, resources, resource templates, and elicitation flows. View all JSON-RPC logs. Support for all features from the official MCP inspector.
Server infoView server icons, version, capabilities, instructions, and ChatGPT widget metadata exposed by the server. Read more

ChatGPT Apps / MCP Apps Builder

Develop ChatGPT apps and MCP apps (Claude) in MCPJam's Apps Builder. Apps Builder is a local emulator to quickly view and iterate on your widgets.

  • Manually invoke a tool to instantly view the widget, or chat with your server using an LLM.
  • View all JSON-RPC messages, window.openai messages in the logs.
  • Change emulator device to Desktop, Tablet, or Mobile views.
  • Test your app's locale change, CSP permissions, light / dark mode, hover & touch, and safe area insets.
<img alt="MCPJam LLM playground" src="./docs/images/pizza-demo.png">

OAuth Debugger

View every step of the OAuth handshake in detail, with guided explanations. Test with every version of the OAuth spec (03-26, 06-18, and 11-25). Support for client pre-registration, Dynamic Client Registration (DCR), and Client ID Metadata Documents (CIMD).

<img alt="MCPJam OAuth Flow Debugger" src="./docs/images/oauth-debugger.png">

LLM Playground

Try your server against any LLM model. We provide frontier models like GPT-5, Claude Sonnet, Gemini 2.5 for free, or bring your own API key. View your server's token usage.

<img alt="MCPJam LLM playground" src="./docs/images/playground.png">

MCP Inspector

MCPJam contains all of the tooling to test your MCP server. Test your server's tools, resources, prompts, templates, with full JSON-RPC observability. MCPJam has all features from the original inspector and more.

<img alt="MCPJam LLM playground" src="./docs/images/mcp-tools.png">

Contributing πŸ‘¨β€πŸ’»

We're grateful for you considering contributing to MCPJam. Please read our contributing guide.

Join our Discord community where the contributors hang out at.

Links πŸ”—

Community 🌍

Shoutouts πŸ“£

Some of our partners and favorite frameworks:

  • Stytch - Our favorite MCP OAuth provider
  • xMCP - The Typescript MCP framework. Ship on Vercel instantly.
  • Alpic - Host MCP servers. Try their new Skybridge framework for ChatGPT apps!

License πŸ“„

This project is licensed under the Apache License 2.0 - see the LICENSE.

Global Ranking

-
Trust ScoreMCPHub Index

Based on codebase health & activity.

Manual Config

{ "mcpServers": { "inspector": { "command": "npx", "args": ["inspector"] } } }