Skip to content

v3.14.0 — OpenAPI + GraphQL tool sources

Choose a tag to compare

@eniz1806 eniz1806 released this 06 Jun 17:44

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 if PyYAML is 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.