Skip to content

everything: get-resource-reference prompt resourceType arg missing description (blocks automated invocation) #3985

Closed

Description

@PengSpirit

Heads-up issue: server-everything (modelcontextprotocol/servers)

Repo: https://github.com/modelcontextprotocol/servers
Filed by: PengSpirit
Filed before: Apr 25, 2026 (72h before Apr 29 launch of mcp-probe)


Title

get-resource-reference prompt: resourceType arg is missing a description, blocks automated invocation

Body

Hi — running mcp-probe against @modelcontextprotocol/server-everything@2026.1.26 surfaces one schema warning that becomes a hard failure when the prompt is invoked:

WARN  get-resource-reference — Property "resourceType" missing description
FAIL  resource-prompt — MCP error -32603: Invalid resourceType: test. Must be Text or Blob.

The server correctly enforces the enum, but because MCP prompt arguments don't carry a JSON schema (only name / description / required), there's no machine-readable way for a caller to know that resourceType accepts only Text or Blob. The convention is to encode allowed values in the description (e.g. "Type of resource. Must be Text or Blob."). Without that, every automated caller has to guess.

Suggested fix: populate the description field on the resourceType argument of the get-resource-reference prompt with prose that names the allowed values, e.g. "Type of resource — must be 'Text' or 'Blob'."

mcp-probe already has a fallback heuristic that extracts allowed values from descriptions matching "must be X or Y" / "one of: X" (commit 3825170 in the mcp-probe repo). Once the description is filled in, this prompt would pass cleanly.

This is a schema-completeness issue, not a server bug — the server itself works correctly. Filing a friendly heads-up because we're about to publish a scorecard that includes this finding, and want maintainers to have time to respond.

Repro:

npx -y @incultnitostudiosllc/mcp-probe test "npx -y @modelcontextprotocol/server-everything"

Thanks for server-everything — it's the most useful integration test target in the ecosystem precisely because it exercises every protocol corner.

Activity

  1. added
    enhancementNew feature or request
    server-everythingReference implementation for the Everything MCP server - src/everything
    on Oct 19, 2026
  2. cliffhall commented on Oct 19, 2026

    @cliffhall
    Member

    Triage: Priority Low (total 3)

    • Severity 1: The prompt argument's description ('Type of resource to fetch') does not name the allowed values Text and Blob; naming them is a small usability fix.
    • Urgency 2: wanted eventually
    • Bonuses: none

    Board: Servers V2 (#43), Status Incoming, awaiting maintainer review (no milestone yet). Part of the backlog triage in #4875.

  3. cliffhall commented on Oct 20, 2026

    @cliffhall
    Member

    Prior work, from the PR backlog triage (#4877). These outside pull requests addressed this issue against the pre-refactor code:

    They are being closed as part of the backlog triage in #4875, since the repository now takes issues rather than outside PRs and their diffs predate the v2 refactor. They stay readable and serve as prototypes for the fix here. Thank you to their authors.

  4. added this to the v2.3.0 milestone on Oct 25, 2026
  5. self-assigned this
    on Oct 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

enhancementNew feature or requestserver-everythingReference implementation for the Everything MCP server - src/everythingv2

Type

No type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions