Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

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

Open Beginner friendly
  • Is something wrong?
#3,985 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
76/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Quiet
Tech stack
typescript
Domain
api, backend-api-design

Research direction

Locate the get-resource-reference prompt in the server-everything implementation and inspect the resourceType argument definition. Add a description that states the allowed Text and Blob values, then run the provided mcp-probe command to confirm the schema warning and automated invocation failure are resolved.

Written by the indexing model from the issue text.

Description

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/[email protected] 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.

Dominant language
TypeScript
Stars
90.5k
Forks
11.7k
Avg merge
5d 19h
Merged PRs (30d)
6

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from modelcontextprotocol/servers

All issues in modelcontextprotocol/servers

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.