v3.14.0 — OpenAPI + GraphQL tool sources
Turn any REST or GraphQL API into tools — no code generation.
Added
- OpenAPI specs as tools —
/mcp add <name> --spec <url|file> [--base-url U]. Kodiqa reads the spec and exposes one tool per operation (path/query/body params become the tool's arguments); calling a tool issues the HTTP request. JSON specs work out of the box; YAML ifPyYAMLis installed. - GraphQL endpoints as tools —
/mcp add <name> --graphql <url>. Kodiqa introspects the schema, exposes each query/mutation as a tool, auto-generates a selection set of the return type's scalar fields, and sends parameterized queries. - Both reuse the existing auth flags (
--bearer,--header,env:/file:), show their kind in/mcp list([openapi]/[graphql]), and work with lazy mode and TOON like any other tool source.
Tests
test_api_tools.py— spec/introspection parsing plus real in-process HTTP servers for OpenAPI (path/query/body) and the GraphQL introspect→query flow. 452 total; ruff + CI green.