Skip to content

fix: generate openAI-compatible json schemas for list types #272

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Aug 22, 2025
Merged

fix: generate openAI-compatible json schemas for list types #272

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
b437692
fix: generate openAI-compatible json schemas for list types
DaleSeo Aug 20, 2025
04cee88
chore: add changeset
DaleSeo Aug 22, 2025
ee83b8c
test: update test snapshots after OpenAI compatibility fix
DaleSeo Aug 22, 2025
a0efb1e
refactor: use schema_factory consistently
DaleSeo Aug 22, 2025
3f2c5f6
test: add tests for input object lists
DaleSeo Aug 22, 2025
fca294f
test: revert the unrelated changes in custom_scalar_map.rs
DaleSeo Aug 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changesets/fix_openai_incompatibility.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
### fix: generate openAI-compatible json schemas for list types - @DaleSeo PR #272

The MCP server is generating JSON schemas that don't match OpenAI's function calling specification. It puts `oneOf` at the array level instead of using `items` to define the JSON schemas for the GraphQL list types. While some other LLMs are more flexible about this, it technically violates the [JSON Schema specification](https://json-schema.org/understanding-json-schema/reference/array) that OpenAI strictly follows.

This PR updates the list type handling logic to move `oneOf` inside `items` for GraphQL list types.
Loading