skills.rest
UNCTAD-eRegistrations
UNCTAD-eRegistrationsOFFICIAL
Explore all skills by this author →
GitHub

mcp-issue

Document MCP tool issues with reproduction steps and environment details.

Updated Feb 19, 2026
Search Tags:#mcp#diagnostics#bug-report#issue-report#reproducible-debugging
One-click install
npx skills add https://github.com/UNCTAD-eRegistrations/plugin-marketplace --skill mcp-issue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-issue
Source: https://github.com/UNCTAD-eRegistrations/plugin-marketplace/tree/main/plugins/bpa-mcp/skills/mcp-issue
Command: npx skills add https://github.com/UNCTAD-eRegistrations/plugin-marketplace --skill mcp-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Report a BPA MCP tool that produced wrong results, failed unexpectedly, or behaved differently from the BPA web UI. Use when the user says something went wrong, a tool gave incorrect output, the result doesn't match the UI, data was corrupted, a mapping is wrong, or they want to file a bug against the MCP server. Also triggers on phrases like "this is broken", "that's not right", "the tool did the wrong thing", "it should have done X instead", or "report this bug".

Core Features & Use Cases

  • Structured Issue Reporting: guides the user to document problem statements, reproduction steps, and environmental details in a consistent format.
  • Contextual Association: links the issue to the specific MCP instance and service to enable targeted triage.
  • Reproducibility Assistance: collects artifacts (logs, screenshots, error messages) to improve debugging efficiency.

Quick Start

Describe the failing MCP action you performed, and I will generate a ready-to-submit issue report.

Frequently Asked Questions about mcp-issue

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

FAQPage Schema
How do I report an MCP tool issue for reproducible debugging?▼

To report an MCP tool issue for reproducible debugging, describe the failing action and the system will collect context, reproduction steps, environment details, and artifacts into a structured report. This structured format ensures MCP developers can quickly triage and resolve the issue.

What should I include in an MCP bug report when a tool gives wrong results?▼

When an MCP tool gives wrong results, your bug report should include the problem statement, steps to reproduce, environment details, and artifacts like logs or error messages. Linking the issue to the specific MCP instance and service enables targeted triage.

When do I need to create a structured issue report for an MCP server?▼

You need to create a structured issue report for an MCP server when you observe wrong results, UI mismatches, data corruption, or unexpected behavior. Triggering phrases like 'this is broken' or 'the tool did the wrong thing' indicate it is time to document the problem.

Does this issue reporting method work for UI mismatches and data corruption in MCP tools?▼

Yes, this issue reporting method works for UI mismatches and data corruption in MCP tools. It applies when a tool behaves differently from the web UI or produces incorrect output, guiding you to document the context and reproduction steps for faster fixes.

What is the best way to document MCP tool failures for faster fixes?▼

The best way to document MCP tool failures for faster fixes is using a structured issue report that captures contextual association with the MCP instance. Collecting artifacts like screenshots and logs alongside reproduction steps improves debugging efficiency for developers.

Related Skills

Explore More Software Engineering Skills→
mediar-aimediar-ai
1.6k

Terminator Issue Reporter

Generate structured GitHub issues for Terminator failures with logs and reproduction steps.

Official
Advanced
CodePhobiiaCodePhobiia
8

bug-report

Create structured bug reports with repro steps and severity classification.

Community
Intermediate
UNCTAD-eRegistrationsUNCTAD-eRegistrations

eregistrations-docs

Analyze BPA service JSON exports and generate structured Excel reports.

Official
Intermediate
anorthamanortham

bug-detective

Diagnose bugs through guided reproduction, tracing, and test-driven verification.

Community
Advanced