tools/list is rejected: three outputSchemas declare a bare oneOf with no type
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 72/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- typescript
- Domain
- api, backend-api-design
Research direction
Start by locating the tools/list outputSchema declarations for rename_document, archive_document, and restore_document, then inspect how the output schema array is assembled. Ensure the advertisement remains valid when a oneOf output schema is present, and verify that tools/list accepts these tools and future oneOf entries.
Written by the indexing model from the issue text.
Description
rename_document, archive_document and restore_document declare an outputSchema that is a bare oneOf with no type.
MCP types a tool's outputSchema as an object schema. A client that validates the advertisement rejects it — and rejects the whole tools/list response rather than the offending tool, so every tool goes unavailable, not the three that are malformed. Claude Code reports:
chopin: https://<host>/mcp (HTTP) - ! Connected · tools fetch failed
Invalid input (at tools.3.outputSchema.type)
The health line leads with Connected and buries the reason, so the failure reads as a healthy server.
Both branches of each oneOf are already object schemas. The constraint belongs to the array rather than to those three entries: any tool added later with a oneOf output takes the advertisement dark the same way.
- Dominant language
- TypeScript
- Stars
- 351
- Forks
- 20
- Avg merge
- 13h 49m
- Merged PRs (30d)
- 34
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from githubnext/chopin
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
githubnext/chopin#149 ·
-
githubnext/chopin#157 · 1 assignee ·
-
githubnext/chopin#156 · 1 assignee ·
-
Difficulty 3/5 1-2 days Newbie friendliness 35/100
githubnext/chopin#151 ·
-
bug
Difficulty 3/5 1-2 days Newbie friendliness 55/100
githubnext/chopin#150 ·
All issues in githubnext/chopin
Similar issues
-
calcite-components needs triage refactor
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Esri/calcite-design-system#15203 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 91/100
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
Difficulty 1/5 Under an hour Newbie friendliness 95/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Automattic/studio#4908 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 90/100