mcp-spy

Analyze MCP server traffic logs to diagnose latency and protocol compliance.

24|6|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/johnlindquist/claude --skill mcp-spy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-spy
Source: https://github.com/johnlindquist/claude/tree/main/skills/mcp-spy
Command: npx skills add https://github.com/johnlindquist/claude --skill mcp-spy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debug MCP server communication. Use for troubleshooting MCP integrations, viewing traffic, and analyzing latency.

Core Features & Use Cases

  • View recent MCP traffic logs
  • Filter logs by type (tool_use, errors, specific tools)
  • Latency analysis and timeout detection
  • Common issue guidance and quick fixes

Quick Start

Use the MCP Spy commands to tail logs, filter by error patterns, and measure latency of a specific tool call.

Frequently Asked Questions about mcp-spy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug MCP server communication and traffic issues?

MCP Spy debugs MCP server communication by displaying recent traffic logs, filtering by message type and errors, and measuring latency to identify failed requests and protocol compliance problems across Claude and MCP servers.

How can I analyze latency and timeouts in MCP tool calls?

Use MCP Spy's latency analysis to measure specific tool call performance and detect timeout issues, helping you identify slow or failing requests in your MCP integrations.

Can I filter MCP logs by error type or specific tools?

Yes. MCP Spy filters logs by error patterns, tool_use events, and specific tools, allowing you to isolate and diagnose particular failure modes in your MCP traffic.

What should I check first when MCP integration stops working?

View recent MCP traffic logs with MCP Spy to see message flow, identify failed requests, and check protocol compliance between Claude and your MCP servers before troubleshooting further.

How do I troubleshoot MCP latency in production environments?

MCP Spy measures tool call latency and detects timeouts in production, providing common issue guidance and quick fixes to resolve performance problems in deployed MCP integrations.