Skip to main content
Glama
esinecan

MCP Inspector as MCP Server

by esinecan

MCP Inspector as MCP Server

License: MIT Node.js TypeScript

A lean MCP server that enables LLMs to inspect and test other MCP servers. This is a self-contained implementation built on the MCP SDK v2 packages directly, without shelling out to external CLIs.

Features

  • Direct SDK integration: Built on the MCP SDK v2 packages, @modelcontextprotocol/server for serving the inspector tools and @modelcontextprotocol/client for connecting to target servers

  • All transport types: Supports stdio, SSE, and HTTP (streamable) transports

  • Small footprint: Two runtime dependencies, the @modelcontextprotocol v2 client and server packages

  • Protocol-era aware client: When connecting to a target server, can negotiate the legacy 2025-era handshake or the modern stateless protocol and report which era the server actually answered as (see Protocol negotiation)

  • Full MCP inspection: List tools, call tools, list resources, read resources, list prompts, get prompts

  • Session management: Persistent connections with automatic garbage collection

  • Event buffering: Capture notifications, traffic, and errors for debugging

Related MCP server: Mock MCP Server

Installation

npm install
npm run build

Usage

As an MCP Server

Add to your MCP config. While there are slight variances between different harnesses, the general format is the same:

{
  "mcpServers": {
    "mcp-inspector": {
      "command": "node",
      "args": ["/path/to/mcp-inspector-as-mcp-server/dist/server.js"]
    }
  }
}

Available Tools

Session Management (NEW in v2.0)

Tool

Description

insp_connect

Establish a persistent connection to an MCP server. Returns a session_id.

insp_disconnect

Close a persistent session and release resources.

insp_list_sessions

List all active sessions with their status and idle time.

insp_read_events

Read buffered events (notifications, traffic, errors) from a session.

insp_inject_steering

Inject a human steering message into a session's queue.

Inspection Tools

Tool

Description

insp_tools_list

List all tools exposed by an MCP server

insp_tools_call

Call a tool on an MCP server

insp_resources_list

List all resources exposed by an MCP server

insp_resources_read

Read a specific resource

insp_resources_templates

List resource templates

insp_prompts_list

List all prompts

insp_prompts_get

Get a specific prompt

Connection Parameters

All tools accept the following connection parameters:

For stdio transport (local commands):

  • command: Command to run (e.g., "node", "python")

  • args: Array of arguments (e.g., ["path/to/server.js"])

For SSE/HTTP transport (remote servers):

  • url: Server URL (e.g., "http://localhost:3000/sse")

  • headers: Optional HTTP headers object

Common:

  • transport: Force transport type ("stdio", "sse", or "http"). Auto-detected if not specified.

  • negotiation: Protocol era to negotiate as a client ("legacy", "auto", or a pinned revision). See Protocol negotiation.

  • session_id: (Optional) Use an existing persistent session instead of creating an ephemeral connection.

Protocol negotiation

When the inspector connects to a target server as a client, it speaks the MCP protocol. The protocol has two eras: the legacy 2025-era initialize handshake, and the newer modern (stateless) revision (2026-07-28 and later). The negotiation parameter controls which era the inspector asks for:

  • "legacy" (default): the SDK default. Perform the traditional initialize handshake. Maximum compatibility; works with every server.

  • "auto": probe the server to find out whether it speaks the modern stateless protocol, falling back to legacy. Use this to verify that a server actually serves modern clients.

  • a pinned revision string (e.g. "2026-07-28"): request a specific protocol revision.

Why this matters: a server that supports both eras will always answer as legacy when the client does not ask for anything else. Without negotiation: "auto" (or a pinned modern revision) you cannot tell, from a successful connection, whether a target server really supports the modern protocol. It simply negotiated down to legacy. This is the single most useful signal the inspector can return about a server during the SDK migration.

insp_connect and insp_list_sessions report the outcome per session. In the insp_connect response look for protocol_version (the negotiated MCP revision, e.g. 2025-11-25 or 2026-07-28) and era (legacy or modern); insp_list_sessions carries the same two values on each session in its listing.

Note on the inspector itself. The inspector is a tier-1 server: ported to the v2 SDK packages, it serves clients of both protocol eras, but it is not discoverable as a modern server. It does not implement server/discover (the call returns -32601 method not found) or subscriptions/listen. The negotiation parameter only governs how the inspector behaves as a client toward other servers.

Session Workflow

For debugging stateful server behavior, use persistent sessions:

1. insp_connect → returns session_id
2. insp_tools_list (with session_id) → uses persistent connection
3. insp_tools_call (with session_id) → state is preserved
4. insp_read_events (with session_id) → see notifications
5. insp_disconnect (with session_id) → cleanup

Sessions auto-close after 30 minutes of inactivity.

Human Steering & Observability

The inspector enables human-in-the-loop workflows where you can observe and guide LLM-driven MCP testing in real-time.

How It Works

┌─────────────┐     MCP calls      ┌─────────────────┐     forwards     ┌─────────────┐
│   LLM Agent │ ◄────────────────► │  MCP Inspector  │ ◄──────────────► │  Target MCP │
│  (Antigravity)                   │    (v2.0)       │                  │   Server    │
└─────────────┘                    └────────┬────────┘                  └─────────────┘
                                            │
                                   Events logged to
                                   session EventBuffer
                                            │
                    ┌───────────────────────┼───────────────────────┐
                    │                       │                       │
                    ▼                       ▼                       ▼
            insp_read_events         HTTP :9847/api          mcp-steer CLI
            (LLM reads events)       (external access)       (human injection)

Viewing Activity

Via LLM: The agent can call insp_read_events to see what's happening:

{
  "session_id": "sess_abc123",
  "types": ["traffic_in", "traffic_out"],
  "limit": 20
}

Via HTTP: Query the steering API directly:

curl http://127.0.0.1:9847/api/sessions

Steering the Agent

Inject guidance messages that appear in the LLM's next tool response.

Using the CLI:

./bin/mcp-steer.mjs "Focus on testing the error handling paths"
./bin/mcp-steer.mjs --session sess_abc123 "Try calling with invalid params"

Using HTTP:

curl -X POST http://127.0.0.1:9847/api/steer \
  -H "Content-Type: application/json" \
  -d '{"message": "Check the authentication flow next"}'

Using the MCP tool:

{
  "tool": "insp_inject_steering",
  "arguments": {
    "session_id": "sess_abc123",
    "message": "Great progress! Now test edge cases."
  }
}

Event Types

Type

Description

traffic_out

Messages sent TO the target server

traffic_in

Messages received FROM the target server

notification

MCP notifications from the target server

error

Errors encountered during communication

steering

Human steering messages injected into the session

Typical Workflow

  1. LLM creates session: insp_connect → gets sess_abc123

  2. LLM starts testing: insp_tools_call with session_id

  3. Human observes: curl http://127.0.0.1:9847/api/sessions

  4. Human steers: ./bin/mcp-steer.mjs "Also test the batch endpoint"

  5. LLM receives steering: Next tool response includes ⚡ STEERING from human: ...

  6. LLM adapts: Takes the human guidance into account

Examples

List tools from a local MCP server (ephemeral):

{
  "command": "node",
  "args": ["/path/to/some-mcp-server/dist/server.js"]
}

Create a persistent session:

{
  "command": "node",
  "args": ["/path/to/some-mcp-server/dist/server.js"]
}
// Returns: { "session_id": "sess_abc123", "server_info": {...} }

Call a tool using a session:

{
  "session_id": "sess_abc123",
  "tool_name": "search",
  "tool_args": {"query": "hello"}
}

Architecture

├── src/
│   ├── server.ts     # MCP server exposing inspector tools
│   ├── client.ts     # Client wrapper (hybrid stateless/session mode)
│   ├── transport.ts  # Transport factory (stdio, SSE, HTTP) + TracingWrapper
│   ├── session.ts    # SessionRegistry with GC (30-min TTL)
│   └── events.ts     # EventBuffer (ring buffer for notifications)
├── bin/
│   └── mcp-steer.mjs # CLI tool for human steering
├── tests/            # Integration test scripts (run with npx tsx)
└── vitest.config.ts  # Unit test + coverage config

Why This Exists

The original MCP Inspector is a web-based UI + CLI combo spread across multiple projects. This consolidates the core functionality into a single, lean MCP server that an LLM can use to:

  1. Develop and debug MCP servers iteratively

  2. Test MCP server functionality without leaving the conversation

  3. Explore what tools/resources/prompts an MCP server exposes

  4. Debug stateful behavior with persistent sessions

Development

npm install          # install dependencies
npm run build        # compile TypeScript
npm run dev          # watch mode
npm test             # run unit tests
npm run test:cov     # run tests with coverage
npm run lint         # lint source files
npm run format       # auto-format with Prettier
npm run typecheck    # type-check without emitting

Changelog

Unreleased

  • Added the negotiation connection parameter for client-side protocol-era negotiation (legacy / auto / pinned revision)

  • insp_connect and insp_list_sessions now report the negotiated protocol revision and era of each session

v2.1.0

  • Added human steering (insp_inject_steering) for human-in-the-loop workflows

  • Added HTTP API on port 9847 for external steering/observability

  • Added mcp-steer.mjs CLI tool for easy human interaction

  • Fixed critical bug in TracingTransportWrapper where handler capture timing caused message loss

v2.0.0

  • Added session management (insp_connect, insp_disconnect, insp_list_sessions)

  • Added event buffering (insp_read_events)

  • All inspection tools now support optional session_id for persistent connections

  • Added automatic garbage collection (30-minute TTL for idle sessions)

  • Backward compatible: omit session_id for original ephemeral behavior

v1.0.0

  • Initial release with ephemeral connections

License

MIT

Available Tools

7 tools
insp_prompts_getC

Get a specific prompt from an MCP server.

ParametersJSON Schema
NameRequiredDescriptionDefault
commandNoCommand to run the MCP server (e.g., 'node', 'python')
argsNoArguments to pass to the command (e.g., ['build/index.js'])
urlNoURL for SSE/HTTP transport (alternative to command)
transportNoTransport type (auto-detected if not specified)
headersNoHTTP headers for SSE/HTTP transport
prompt_nameYesName of the prompt to get
prompt_argsNoArguments to pass to the prompt

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure but offers minimal information. It states the tool retrieves a prompt but doesn't describe what happens if the prompt doesn't exist, whether authentication is required, if there are rate limits, what format the prompt returns in, or whether this is a read-only operation. The description is too basic for a tool with 7 parameters and server interaction.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence that gets straight to the point with zero wasted words. It's appropriately sized for a retrieval operation and front-loads the essential information. Every word earns its place in communicating the core functionality.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 7 parameters, server communication, and no output schema, the description is insufficiently complete. It doesn't explain what constitutes a 'prompt' in this system, what the return format looks like, error handling, or authentication requirements. The combination of complex parameters and no annotations means the description should provide more contextual information about the operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 7 parameters thoroughly. The description adds no additional parameter information beyond what's in the schema - it doesn't explain relationships between parameters (like command/args vs url/transport), provide examples of prompt_name formats, or clarify when prompt_args are needed. This meets the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Get') and resource ('a specific prompt from an MCP server'), making the purpose immediately understandable. It distinguishes from sibling tools like 'insp_prompts_list' by specifying retrieval of a single prompt rather than listing multiple. However, it doesn't explicitly mention what 'prompt' refers to in this context (e.g., AI prompt templates, system prompts).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention when to choose this over 'insp_prompts_list' (for listing all prompts) or 'insp_tools_call' (which might handle different operations). There's no discussion of prerequisites, error conditions, or typical use cases for prompt retrieval.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

insp_prompts_listC

List all prompts exposed by an MCP server.

ParametersJSON Schema
NameRequiredDescriptionDefault
commandNoCommand to run the MCP server (e.g., 'node', 'python')
argsNoArguments to pass to the command (e.g., ['build/index.js'])
urlNoURL for SSE/HTTP transport (alternative to command)
transportNoTransport type (auto-detected if not specified)
headersNoHTTP headers for SSE/HTTP transport

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states it's a list operation, implying read-only behavior, but doesn't mention any side effects, permissions required, rate limits, or what the output format looks like. For a tool that interacts with external servers, this lack of operational context is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence that efficiently conveys the core purpose without any fluff. It's front-loaded with the main action and resource, making it easy to parse. Every word earns its place in defining what the tool does.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of connecting to external servers via multiple transport methods and the lack of annotations and output schema, the description is insufficient. It doesn't explain what 'prompts' are in this context, how results are returned, or any error conditions. For a tool with 5 parameters and no structured safety hints, more operational detail is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema fully documents all 5 parameters. The description adds no parameter-specific information beyond implying the tool connects to an MCP server. This meets the baseline of 3 where the schema does the heavy lifting, but the description doesn't compensate with additional context like default behaviors or parameter interactions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('List all prompts') and the target resource ('exposed by an MCP server'), making the purpose immediately understandable. It distinguishes from siblings like insp_tools_list by specifying 'prompts' rather than 'tools', but doesn't explicitly contrast with insp_prompts_get, which would fetch a specific prompt rather than list all.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like insp_prompts_get or insp_tools_list. It mentions the scope ('all prompts') but offers no context about prerequisites, typical use cases, or limitations that would help an agent decide between this and sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

insp_resources_listC

List all resources exposed by an MCP server.

ParametersJSON Schema
NameRequiredDescriptionDefault
commandNoCommand to run the MCP server (e.g., 'node', 'python')
argsNoArguments to pass to the command (e.g., ['build/index.js'])
urlNoURL for SSE/HTTP transport (alternative to command)
transportNoTransport type (auto-detected if not specified)
headersNoHTTP headers for SSE/HTTP transport

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states it 'lists' resources, implying a read-only operation, but doesn't cover aspects like whether it requires authentication, how it handles errors, if it's rate-limited, or what the output format looks like (e.g., JSON list). This leaves significant gaps for an agent to understand its behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence that front-loads the core purpose without unnecessary words. It efficiently conveys the essential information, making it easy for an agent to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (5 parameters, no annotations, no output schema), the description is insufficient. It doesn't explain what 'resources' entail in this context, how results are returned, or any behavioral traits like error handling. For a tool that likely inspects server capabilities, more context is needed to guide effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, so parameters are well-documented in the schema itself. The description adds no additional meaning about parameters beyond implying the tool interacts with an MCP server, which is already inferred from the schema's command/args/url fields. This meets the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('List all resources') and the target ('exposed by an MCP server'), providing a specific verb+resource combination. However, it doesn't explicitly differentiate from sibling tools like 'insp_resources_read' or 'insp_resources_templates', which likely have different purposes related to resources.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. With siblings like 'insp_resources_read' (likely for reading a specific resource) and 'insp_resources_templates' (likely for templates), there's no indication of context, prerequisites, or exclusions for this list operation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

insp_resources_readC

Read a specific resource from an MCP server.

ParametersJSON Schema
NameRequiredDescriptionDefault
commandNoCommand to run the MCP server (e.g., 'node', 'python')
argsNoArguments to pass to the command (e.g., ['build/index.js'])
urlNoURL for SSE/HTTP transport (alternative to command)
transportNoTransport type (auto-detected if not specified)
headersNoHTTP headers for SSE/HTTP transport
uriYesURI of the resource to read

TDQS

C2.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states 'Read a specific resource,' implying a read-only operation, but doesn't cover critical aspects like authentication needs, rate limits, error handling, or what the output looks like (e.g., raw data, structured format). For a tool with 6 parameters and no output schema, this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence that directly states the tool's purpose. It's front-loaded with the core action ('Read a specific resource') and avoids unnecessary details. Every word earns its place, making it highly concise and well-structured for quick understanding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (6 parameters, nested objects, no output schema) and lack of annotations, the description is incomplete. It doesn't explain the resource type, how parameters like 'transport' affect behavior, or what the read operation returns. For a tool that likely involves server interaction and resource retrieval, more context is needed to guide effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, meaning all parameters are documented in the input schema. The description adds no additional meaning beyond the schema, such as explaining how parameters interact (e.g., 'command' vs. 'url' for transport) or providing examples. With high schema coverage, the baseline score of 3 is appropriate, as the description doesn't compensate but also doesn't detract.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the tool 'Read a specific resource from an MCP server,' which clearly indicates a read operation on a resource. However, it doesn't specify what type of resource (e.g., file, data object) or differentiate from sibling tools like 'insp_resources_list' (which likely lists resources) or 'insp_resources_templates' (which might handle templates). The purpose is clear but lacks sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., server setup), exclusions (e.g., not for writing), or compare to siblings like 'insp_resources_list' for listing resources. Without such context, an agent might struggle to select the correct tool in a given scenario.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

insp_resources_templatesB

List resource templates exposed by an MCP server.

ParametersJSON Schema
NameRequiredDescriptionDefault
commandNoCommand to run the MCP server (e.g., 'node', 'python')
argsNoArguments to pass to the command (e.g., ['build/index.js'])
urlNoURL for SSE/HTTP transport (alternative to command)
transportNoTransport type (auto-detected if not specified)
headersNoHTTP headers for SSE/HTTP transport

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool lists resource templates but doesn't describe what 'exposed by an MCP server' entails, such as whether this requires server connectivity, authentication, or specific permissions. For a tool with 5 parameters and no annotation coverage, this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that directly states the tool's purpose without unnecessary words. It's front-loaded and wastes no space, making it easy to understand at a glance while being appropriately sized for its function.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (5 parameters, no annotations, no output schema), the description is minimal but covers the basic purpose. It lacks details on behavioral aspects like server interaction requirements or output format, which are important for a tool that likely involves external communication. However, the high schema coverage mitigates some gaps, making it adequate but with clear room for improvement.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, providing clear details for all 5 parameters (e.g., command, args, url, transport, headers). The description doesn't add any parameter-specific information beyond what's in the schema, such as examples or usage context. With high schema coverage, the baseline score of 3 is appropriate as the schema handles the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('List') and target ('resource templates exposed by an MCP server'), providing a specific verb+resource combination. However, it doesn't explicitly distinguish this from sibling tools like 'insp_resources_list' or 'insp_resources_read', which likely handle different aspects of resources, leaving some ambiguity about differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention any prerequisites, context for usage, or comparisons to sibling tools such as 'insp_resources_list', which might handle actual resources rather than templates. This lack of guidance could lead to confusion in tool selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

insp_tools_callC

Call a tool on an MCP server. Connects, calls the tool, and disconnects.

ParametersJSON Schema
NameRequiredDescriptionDefault
commandNoCommand to run the MCP server (e.g., 'node', 'python')
argsNoArguments to pass to the command (e.g., ['build/index.js'])
urlNoURL for SSE/HTTP transport (alternative to command)
transportNoTransport type (auto-detected if not specified)
headersNoHTTP headers for SSE/HTTP transport
tool_nameYesName of the tool to call
tool_argsNoArguments to pass to the tool (key=value pairs)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions connecting, calling, and disconnecting, which implies network/process operations, but doesn't disclose critical traits like error handling, timeouts, authentication needs, rate limits, or what happens if the server is unavailable. For a tool that interacts with external servers, this lack of behavioral context is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise (one sentence) and front-loaded with the core purpose. Every word earns its place by summarizing the tool's lifecycle (connect, call, disconnect). There's no redundancy or fluff, making it efficient for quick understanding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (7 parameters, no annotations, no output schema), the description is incomplete. It doesn't address what the tool returns, error conditions, or how to interpret results from the called tool. For a tool that dynamically invokes other tools on a server, more context about output format, success/failure states, and integration patterns is needed to be fully helpful.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 7 parameters thoroughly. The description adds no additional meaning beyond what's in the schema (e.g., it doesn't explain parameter interactions or provide examples). With high schema coverage, the baseline score of 3 is appropriate, as the description doesn't compensate but also doesn't detract from the well-documented schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Call a tool on an MCP server' with specific verbs (connects, calls, disconnects). It distinguishes from siblings like insp_tools_list (which lists tools) but doesn't explicitly contrast with other tools that might also involve calling operations. The purpose is well-defined but could be more specific about what distinguishes it from potential alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention siblings like insp_tools_list (which might be used to discover tools before calling) or other tools that might handle MCP server interactions differently. There's no context about prerequisites, error conditions, or typical use cases, leaving the agent with minimal usage direction.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

insp_tools_listC

List all tools exposed by an MCP server. Connects, lists tools, and disconnects.

ParametersJSON Schema
NameRequiredDescriptionDefault
commandNoCommand to run the MCP server (e.g., 'node', 'python')
argsNoArguments to pass to the command (e.g., ['build/index.js'])
urlNoURL for SSE/HTTP transport (alternative to command)
transportNoTransport type (auto-detected if not specified)
headersNoHTTP headers for SSE/HTTP transport

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions the connection and disconnection process, which is helpful, but lacks critical details such as whether this is a read-only operation, potential side effects (e.g., server state changes), error handling, or performance considerations (e.g., timeouts). For a tool that interacts with external servers, this is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise—just one sentence with three clauses—and front-loaded with the core purpose. Every word earns its place by conveying essential information about the tool's function and operational flow without any redundancy or fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of connecting to and querying an MCP server, the description is incomplete. It lacks details on output format (no output schema is provided), error conditions, authentication needs, or rate limits. While the schema covers parameters well, the overall context for safe and effective use is insufficient, especially for a tool with external dependencies.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, meaning all parameters are documented in the input schema. The description adds no additional parameter semantics beyond what's in the schema (e.g., it doesn't explain parameter interactions or provide examples). This meets the baseline score of 3 for high schema coverage, but doesn't compensate with extra value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('List all tools') and resource ('exposed by an MCP server'), providing a specific verb+resource combination. It also mentions the operational flow ('Connects, lists tools, and disconnects'), which adds useful context. However, it doesn't explicitly differentiate this tool from its sibling 'insp_tools_call', which appears to be for invoking tools rather than listing them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'insp_tools_call' or other sibling tools. It mentions the operational steps but doesn't specify prerequisites, use cases, or exclusions. This leaves the agent without clear direction on tool selection in context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 7 tool updatesv1.0.0
    • First observedinsp_prompts_get
    • First observedinsp_prompts_list
    • First observedinsp_resources_list
    • First observedinsp_resources_read
    • First observedinsp_resources_templates
    • First observedinsp_tools_call
    • First observedinsp_tools_list

TDQS

A3.5/5.0
Disambiguation5/5

Every tool has a clearly distinct purpose targeting different MCP server components: prompts (get/list), resources (list/read/templates), and tools (list/call). There is no overlap or ambiguity in functionality, making it easy for an agent to select the correct tool.

Naming Consistency5/5

All tools follow a consistent 'insp_[component]_[action]' pattern with snake_case, using clear verbs like get, list, read, call, and templates. This predictability enhances usability and reduces confusion.

Tool Count5/5

With 7 tools, the server is well-scoped for inspecting MCP servers, covering prompts, resources, and tools comprehensively. Each tool earns its place without being excessive or insufficient for the domain.

Completeness5/5

The tool set provides complete coverage for inspecting MCP servers, including listing and accessing prompts, resources (with templates), and tools (with calling capability). There are no obvious gaps, ensuring agents can perform all necessary inspection tasks.

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    A dual-transport MCP server that exposes your API as tools to LLM clients, supporting both stdio transport for local clients like Claude Desktop and HTTP/SSE transport for remote clients like OpenAI's Responses API.
    -
  • A
    license
    B
    quality
    D
    maintenance
    A mock MCP server for testing MCP client implementations and development workflows. Supports tools, prompts, and resources across multiple transport protocols (stdio, HTTP, SSE).
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that publishes CLI tools on your machine for discoverability by LLMs
    14
    1
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables LLM agents to programmatically inspect, debug, and test other MCP servers by wrapping the MCP Inspector CLI. Supports listing and calling tools, reading resources, and testing prompts on both local and remote MCP servers.
    6
    20
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/esinecan/mcp-inspector-as-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server