qa-find-bugs-mcp

Hunt bugs in the Beancount.io MCP server by driving live JSON-RPC endpoint journeys.

275|32|Updated Oct 2, 2020
One-click install
npx skills add https://github.com/bex-co/beancount-io --skill qa-find-bugs-mcp-bex-co
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-find-bugs-mcp
Source: https://github.com/bex-co/beancount-io/tree/main/.agents/skills/qa-find-bugs-mcp
Command: npx skills add https://github.com/bex-co/beancount-io --skill qa-find-bugs-mcp-bex-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Testing a remote MCP (Model Context Protocol) server for correctness is hard: transport quirks, credential scoping, error envelopes, and parity with REST/GraphQL surfaces all need systematic verification against a live endpoint rather than unit tests. This Skill provides a structured bug-hunting workflow that exercises the real POST /api-gateway/mcp endpoint and turns surprising behavior into deduplicated, reproducible findings. ## Core Features & Use Cases - Journey-based sweeps: Covers transport, discovery, credential boundaries, reads, resources, writes, prompts, result envelope, rate limits, account tools, and real MCP client sessions, each with observable promises to check. - Credential-safe testing: Uses a bundled helper script so API tokens never reach argv, transcripts, or tool calls, and enforces QA-only accounts and synthetic ledgers for write journeys. - Parity and root-cause analysis: Compares MCP results against REST/GraphQL controls, traces failures to specific source files, distinguishes deployment lag from real bugs, and deduplicates against existing board items. - Use Case: Run an anonymous transport and discovery check against production, then use a pinned read-only key to verify every write tool returns FORBIDDEN, filing any confirmed defect with a minimal reproducer. ## Quick Start Ask the agent to run the MCP bug hunt against the default production endpoint, optionally naming specific journeys, a QA ledger, and providing credential environment variable names.

Frequently Asked Questions about qa-find-bugs-mcp

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

FAQPage Schema
How do I test an MCP server endpoint for bugs?

Drive the live POST /api-gateway/mcp endpoint with JSON-RPC requests covering transport, discovery, boundaries, reads, writes, prompts, and envelope journeys. Use the bundled qa-mcp.mjs helper so credentials never appear in argv or transcripts, and compare results against REST or GraphQL controls.

How do I test MCP tools without exposing my API key?

Run the bundled helper script, which reads the token from the QA_MCP_TOKEN environment variable or a credentials file and redacts it from all output. Never pass the token as a command-line argument, and use short-lived keys pinned to a synthetic QA ledger.

Can I run MCP write tests against production?

Write and admin journeys belong on a designated QA account with a synthetic ledger or an already-running local docker stack, never a personal account. Disposable writes are allowed only in DRY_RUN mode on the designated ledger, and rate-limit write probes must never target production.

What if I have no MCP credential available?

The workflow still runs anonymous transport and discovery checks, such as verifying 401 responses with a resolving RFC 9728 discovery pointer and method handling. Every authenticated journey is marked unverified, and you are asked for a credential variable name or file path, never the value.

Why does the served MCP prompt differ from the source code?

A difference between served prompt text and the repository source is usually deployment lag, not a bug. The workflow checks the commit that already changed the text and existing board items before filing, classifying the difference as lag rather than a new defect.