βœ“
Inspector Download

Local development client for ChatGPT apps and MCP servers with full widget emulator, OAuth debugger, LLM playground with free frontier models (GPT-5, Claude Sonnet, Gemini 2.5), JSON-RPC observability, and Apps Builder supporting Desktop/Tablet/Mobile views via NPX or desktop apps.

⭐ 1,481 stars on GitHub
Latest Release: v1.3.9

About Software

MCPJam Inspector is the local development client for building and testing ChatGPT apps, MCP apps (Claude), and MCP servers. It provides a full widget emulator for instant iteration without ngrok or ChatGPT subscription requirements. Features ChatGPT Apps SDK support with windows.openai API (widgetState, callTool, structuredContent, sendFollowUpMessage, displayMode, CSP), MCP Apps (SEP-1865) with all JSON-RPC message types, and comprehensive OAuth debugging with visual inspection of every network message.

Additional capabilities include LLM playground with free access to frontier models (GPT-5, Claude Sonnet, Gemini 2.5) or custom API keys, MCP server debugging for local/remote connections with manual tool and resource invocation, server info viewing for icons/version/capabilities/instructions/widget metadata, and JSON-RPC observability. Apps Builder emulator supports Desktop/Tablet/Mobile views, locale changes, CSP permissions, light/dark mode, hover/touch, and safe area insets. Available via NPX (@mcpjam/inspector@latest) or desktop apps for Mac and Windows. Apache 2.0 license with active Discord community.

Use Cases:

  • Local development client for ChatGPT apps and MCP servers with full widget emulator eliminating need for ngrok or subscriptions
  • ChatGPT Apps SDK testing with complete windows.openai API support including widgetState, callTool, structuredContent, and CSP
  • MCP Apps (Claude) development with full JSON-RPC message support for tools/call, ui/initialize, ui/message, and ui/open-link
  • OAuth debugging for MCP servers with visual network message inspection supporting all protocol versions (03-26, 06-18, 11-25)
  • LLM playground with frontier models (GPT-5, Claude Sonnet, Gemini 2.5) for free, or bring-your-own-API-key integration

Downloads

v1.3.9 December 10, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.3.8 December 09, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.3.7 December 09, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.3.6 December 08, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.3.5 December 07, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.3.4 December 05, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.3.3 December 04, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.3.2 December 02, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.3.1 December 01, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.3.0 November 30, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.2.9 November 30, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.2.8 November 27, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.2.7 November 27, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.2.6 November 25, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.2.5 November 25, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.2.4 November 25, 2025
MCPJam-Inspector-Setup.exeexe
v1.2.3 November 24, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.2.1 November 20, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.2.0 November 19, 2025
MCPJam-Inspector-Setup.exeexe
MCPJam.Inspector.dmgdmg
v1.1.9 November 18, 2025
MCPJam.Inspector.dmgdmg
v1.1.7 November 18, 2025
MCPJam.Inspector.dmgdmg
v1.1.2 November 10, 2025
MCPJam.Inspector.dmgdmg
v1.1.1 November 09, 2025
MCPJam.Inspector.dmgdmg
v1.1.0 November 08, 2025
MCPJam.Inspector.dmgdmg
v1.0.17 October 22, 2025
MCPJam.Inspector.dmgdmg
v1.0.16 October 20, 2025
MCPJam.Inspector.dmgdmg
v1.0.15 October 20, 2025
MCPJam.Inspector.dmgdmg
v1.0.14 October 20, 2025
MCPJam.Inspector.dmgdmg
v1.0.12 October 16, 2025
MCPJam.Inspector.dmgdmg
v1.0.11 October 15, 2025
MCPJam.Inspector.dmgdmg

Package Info

Last Updated
Dec 10, 2025
Latest Version
v1.3.9
License
NOASSERTION
Total Versions
30

README

www.mcpjam.com

npm version (https://img.shields.io/npm/v/@mcpjam/inspector?style=for-the-badge&color=blue) License: Apache 2.0 (https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge) Discord (https://img.shields.io/badge/Discord-Join%20Server-5865F2.svg?style=for-the-badge&logo=discord&logoColor=white)

MCPJam Inspector is the local development client for ChatGPT apps, MCP apps (Claude), 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

Table of contents

  • Installation Guides
  • Key Features
    • ChatGPT / MCP Apps Builder
    • OAuth Debugger
    • LLM Playground
  • Contributing
  • Links
  • Community
  • Shoutouts
  • License

Installation Guides

Requirements

Node.js (https://img.shields.io/badge/Node.js-20+-green.svg?style=for-the-badge&logo=node.js) TypeScript (https://img.shields.io/badge/TypeScript-5+-blue.svg?style=for-the-badge&logo=typescript)

Install via NPM

We recommend starting MCPJam inspector via npx:

npx @mcpjam/inspector@latest

We also have a Mac and Windows desktop app:

  • Install Mac (https://github.com/MCPJam/inspector/releases/latest/download/MCPJam.Inspector.dmg)
  • Install Windows (https://github.com/MCPJam/inspector/releases/latest/download/MCPJam-Inspector-Setup.exe)

Key features

Capability Description
ChatGPT Apps SDK Local 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 (https://www.mcpjam.com/blog/app-builder)
MCP 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 (https://www.mcpjam.com/blog/mcp-apps-preview)
OAuth Debugger Debug 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 (https://www.mcpjam.com/blog/oauth-debugger)
LLM playground Chat 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 (https://www.mcpjam.com/blog/frontier-models)
MCP server debugging Connect 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 info View server icons, version, capabilities, instructions, and ChatGPT widget metadata exposed by the server. Read more (https://www.mcpjam.com/blog/server-instructions)

ChatGPT Apps / MCP Apps Builder

Develop ChatGPT apps (https://developers.openai.com/apps-sdk/) and MCP apps (Claude) (https://github.com/modelcontextprotocol/modelcontextprotocol/pull/1865) 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.

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).

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.

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.

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

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

Join our Discord community (https://discord.gg/JEnDtz8X6z) where the contributors hang out at.

Links πŸ”—

  • Website (https://www.mcpjam.com/)
  • Blog (https://www.mcpjam.com/blog)
  • Pricing (https://www.mcpjam.com/pricing)
  • Docs (https://docs.mcpjam.com/)

Community 🌍

  • Discord (https://discord.gg/JEnDtz8X6z)
  • 𝕏 (Twitter) (https://x.com/mcpjams)
  • LinkedIn (https://www.linkedin.com/company/mcpjam)

Shoutouts πŸ“£

Some of our partners and favorite frameworks:

  • Stytch (https://stytch.com) - Our favorite MCP OAuth provider
  • xMCP (https://xmcp.dev/) - The Typescript MCP framework. Ship on Vercel instantly.
  • Alpic (https://alpic.ai/) - Host MCP servers. Try their new Skybridge framework (https://github.com/alpic-ai/skybridge) for ChatGPT apps!

License πŸ“„

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

Related Software

Sparky Fitness

Self-hosted family fitness tracking platform with AI nutrition coach, comprehensive food and exercise logging, body measurements, water tracking, and interactive reports powered by Docker deployment.

⭐ 1,777ai, artificial-intelligence, fitness

Opkssh

Passwordless SSH authentication tool using OpenID Connect identities instead of SSH keys, generating time-limited certificates with ID Tokens from Google, Microsoft, GitLab, and custom OIDC providers for cross-platform server access.

⭐ 1,775oidc, openid-connect, ssh

Obamify

Desktop and web application using advanced pixel reassignment algorithm to transform any image into Obama or other target images with adjustable resolution, animation control, and mathematical optimization options.

⭐ 1,733

Cagent

Docker's multi-agent runtime for building and orchestrating specialized AI agents defined in YAML, with MCP tool integration, smart delegation, RAG retrieval, and support for multiple LLM providers including OpenAI, Anthropic, and Gemini.

⭐ 1,732agents, ai

Athas

Lightweight cross-platform code editor built with Tauri combining Rust and React, featuring external editor support for Neovim and Helix, Git integration, AI agents, Vim keybindings, and integrated terminal for Windows, macOS, and Linux.

⭐ 1,722editor, ide, athas

Audio Visual

Cross-platform video parsing tool built with Electron for streaming content from Chinese platforms like Tencent Video, iQiyi, Youku, Bilibili, and Mango TV with multiple parser interfaces, modern UI, automatic updates, and support for Windows, macOS, and Linux.

⭐ 1,716