MCP Surface Discoverability Audit

Inventory MCP tool registrations and compare documented entrypoints to classify gaps.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/JDL440/nfl-eval --skill mcp-surface-discoverability-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: MCP Surface Discoverability Audit
Source: https://github.com/JDL440/nfl-eval/tree/main/.squad/skills/mcp-surface-discoverability-audit
Command: npx skills add https://github.com/JDL440/nfl-eval --skill mcp-surface-discoverability-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

A canonical MCP server can exist with many tools, but operators often rely on README and docs to discover capabilities. This Skill provides a structured method to verify that documented entrypoints align with registered tools and surfaces, reducing discovery friction and onboarding time.

Core Features & Use Cases

  • Inventory the runtime catalog of MCP tools and group them by domain.
  • Compare discoverability surfaces across main docs, tool docs, tests, and legacy entrypoints.
  • Classify gaps such as runtime-only discoverability, code-only schema knowledge, or stale docs to guide safe rollout.
  • Use Case: An operator is preparing a compatibility rollout and needs to verify that all tools are discoverable through docs before release.

Quick Start

Run the audit against your canonical MCP server to verify tool registrations and update surfaces in docs accordingly.

Frequently Asked Questions about MCP Surface Discoverability Audit

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

FAQPage Schema
How do I audit MCP tool discoverability against documented entrypoints?

To audit MCP tool discoverability, inventory the runtime catalog of your canonical MCP server, group tools by domain, and compare registered surfaces against main docs, tool docs, tests, and legacy entrypoints to identify discovery gaps.

What is an MCP tool discoverability audit?

An MCP tool discoverability audit is a structured validation method that identifies gaps between runtime MCP tool registrations and documented entrypoints, classifying discrepancies like runtime-only discoverability, code-only schema knowledge, or stale docs.

How do I check if my MCP server tools are missing from documentation?

Check for missing MCP server tools by running a surface comparison across main docs, tool docs, tests, and legacy entrypoints against the runtime tool inventory to classify gaps and guide safe rollout planning.

When do I need to validate MCP tool surface compatibility?

You need to validate MCP tool surface compatibility when preparing a compatibility rollout to verify that all runtime registered tools are discoverable through documented entrypoints before release, reducing discovery friction and onboarding time.

Does the MCP discoverability audit classify stale documentation gaps?

Yes, the MCP discoverability audit classifies gaps including stale docs, runtime-only discoverability, and code-only schema knowledge, providing a structured method to guide safe surface updates and rollout planning.

What's the best way to inventory MCP tools by domain for a docs update?

The best way to inventory MCP tools by domain is to run an audit against your canonical MCP server, which groups runtime registered tools by domain and validates discoverability surfaces across documentation and tests.