Kong / Kong/deck

openapi2mcp: generated config.tools entries omit the responses field from the OpenAPI spec

Open
#2,129 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Go
Stars
503
Forks
137
Avg merge
3d 5h
Merged PRs (30d)
20

Description

Summary
When converting an OpenAPI spec to MCP configuration (via deck file openapi2mcp, which calls openapi2mcp.Convert), each generated tool under config.tools includes the operation's request contract but not the operation's responses. The OpenAPI responses object is never read during conversion.

Current behavior
operation.Parameters and operation.RequestBody are consumed, but operation.Responses is never accessed anywhere in the package. There is no responses (or equivalent) key in the tool map and no builder function for it.

Expected / desired behavior

Generated tool entries should optionally include response schema information derived from the OpenAPI responses object (e.g. a responses field keyed by status code, each with its media-type content schemas, mirroring the shape of request_body).

Contributor guide

No contributing guide indexed for this repository

Research direction

Start at the deck file openapi2mcp entry point and follow its call to openapi2mcp.Convert, comparing how operation.Parameters and operation.RequestBody are converted. Trace the operation.Responses data and define the generated responses shape with status codes and media-type content schemas; done means config.tools entries preserve that response information when present.

Written by the indexing model from the issue text.

Assessment

Tech stack
go, openapi
Domain
api
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
64/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.