mcp-debugging

Inspect MCP server logs, trace requests via correlation IDs, and analyze tool performance.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/orient-bot/orient --skill mcp-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-debugging
Source: https://github.com/orient-bot/orient/tree/main/.claude/skills/mcp-debugging
Command: npx skills add https://github.com/orient-bot/orient --skill mcp-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve issues with the Model Context Protocol (MCP) server, enabling efficient troubleshooting of tool failures, API errors, and performance degradation.

Core Features & Use Cases

  • Log Analysis: Inspect debug and error logs for detailed operational insights.
  • Request Tracing: Use correlation IDs to follow the lifecycle of specific operations.
  • Performance Monitoring: Identify slow operations by analyzing duration metrics.
  • Use Case: When a Jira ticket update fails, use this skill to trace the request using its correlation ID, examine the logs for specific errors related to the Jira service, and check the arguments passed to the tool.

Quick Start

Use the mcp-debugging skill to check the last 20 lines of the error log file.

Frequently Asked Questions about mcp-debugging

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

FAQPage Schema
How do I debug MCP server tool failures and API errors?

Debug MCP server tool failures by inspecting error logs, tracing request lifecycles via correlation IDs, and examining the arguments passed to the failed tool operation.

What is the best way to trace a failed MCP operation using a correlation ID?

Trace a failed MCP operation by filtering logs with its correlation ID to follow the complete request lifecycle, isolating specific service errors and the exact tool arguments passed.

How do I monitor MCP server performance and identify slow operations?

Monitor MCP server performance by analyzing duration metrics for tool operations, which helps identify slow API calls and pinpoint the root cause of performance degradation.

Can I filter MCP server logs by specific service or operation type?

Yes, you can filter MCP server logs by specific service or operation type, enabling targeted troubleshooting and real-time monitoring of relevant tool operations.

How do I check recent MCP server error logs for troubleshooting?

Check recent MCP server error logs by inspecting the last lines of the error log file, providing immediate operational insights into API failures and tool execution issues.