From mcp-spec
Searches MCP PRs, issues, and discussions in modelcontextprotocol GitHub org using gh CLI, GraphQL, and variant search terms. Guides prioritization, deep PR dives, and historical research.
npx claudepluginhub modelcontextprotocol/modelcontextprotocol --plugin mcp-specThis skill uses the workspace's default tool permissions.
- **MCP Docs Server** (`mcp-docs` MCP server → `SearchModelContextProtocol` tool): Authoritative for current spec content. **Prefer this first** for specification details, API references, and protocol concepts.
Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Analyzes competition with Porter's Five Forces, Blue Ocean Strategy, and positioning maps to identify differentiation opportunities and market positioning for startups and pitches.
mcp-docs MCP server → SearchModelContextProtocol tool): Authoritative for current spec content. Prefer this first for specification details, API references, and protocol concepts.gh search prs / gh search issues in modelcontextprotocol/modelcontextprotocol (searches open and closed by default)For historical decisions, prioritize merged PRs and closed issues over open items.
There is no gh search discussions command. Use the GraphQL API:
# Spec-repo discussions
gh api graphql -f query="query { search(query: \"repo:modelcontextprotocol/modelcontextprotocol <topic>\", type: DISCUSSION, first: 20) { nodes { ... on Discussion { title url body author { login } authorAssociation category { name } answer { author { login } authorAssociation body } } } } }"
# Org-wide discussions
gh api graphql -f query="query { search(query: \"org:modelcontextprotocol <topic>\", type: DISCUSSION, first: 20) { nodes { ... on Discussion { title url body author { login } authorAssociation category { name } answer { author { login } authorAssociation body } } } } }"
GitHub search does not split camelCase tokens. ToolAnnotations and Tool Annotations return almost entirely different results — search both.
ToolAnnotations, inputSchema): matches identifiers in code and schemaTool Annotations, input schema): matches natural-language discussion textSkip kebab-case variants (tool-annotations) — GitHub tokenizes on hyphens, so they behave like the space-separated form but tend to return noisier results.
When to deep dive: a search result PR looks highly relevant to the topic, and you need to understand why a change was made, not just what changed
During a deep dive, look through:
repos/modelcontextprotocol/modelcontextprotocol/issues/{pr_number}/comments)repos/modelcontextprotocol/modelcontextprotocol/pulls/{pr_number}/comments)repos/modelcontextprotocol/modelcontextprotocol/pulls/{pr_number}/reviews)Each comment returned by these endpoints includes an author_association field — use it to identify maintainers (see Notable maintainer quotes).
- [#123](url) - PR Title (**Merged/Closed/Open** <date>)
Brief summary of PR
- [#456](url) - Issue Title (**Open/Closed** <date>)
Brief summary of issue
- [#789](url) - Discussion Title (<date>)
Brief summary of discussion content
Identifying maintainers: The GitHub API includes an author_association field (REST) or authorAssociation (GraphQL) on every comment. Treat users with association MEMBER or OWNER as maintainers.
When maintainers make comments that reveal design intent, set direction, or explain rationale, quote them directly with attribution and a footnote:
"These would require a SEP. I think the general question here is about the taxonomy of hints." [^1] — @dsp-ant
Look for quotes that:
Summarize the most important findings and any decisions or consensus reached.
Collect all sources as footnotes at the end. Every quote and claim presented in the output should have a corresponding footnote. For example:
[^1]: [#616 inline review comment by @dsp-ant](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/616#discussion_r...)
[^2]: [#185 ToolAnnotations](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/185)
[^3]: [Spec: Tool Annotations (2025-11-25)](https://modelcontextprotocol.io/specification/2025-11-25/server/tools)
SearchModelContextProtocol tool (if available) to search for current specification details and conceptsgh CLI tool if available)