Getting Started

Install

You don't need to install anything. Run the generator with npx:

npx klaridian generate --spec ./api.yaml --out ./my-server --plugin otel

klaridian is a CLI today. There's no library mode yet (no import/require)—that's tracked separately, not built.

What you get

• One MCP tool per operation in your OpenAPI spec
• Tool names match your spec's operationIds exactly
• A stateless TypeScript server, ready to run
• OpenTelemetry tracing already wired in, if you passed --plugin otel

Got a Swagger 2.0 spec? Pass it the same way—klaridian detects it and converts it to OpenAPI 3.0 before generating, so you don't have to convert it yourself.

Two ways to generate

By default, klaridian makes one MCP tool per API operation. This works well for small and medium specs.

For large specs (dozens or hundreds of operations), that gets noisy. Use --architecture code-mode instead—it generates a typed client and just two tools (execute_code, search_docs). See Code-mode architecture.

Next steps

• Curating the tool surface—control which operations become tools
• Code-mode architecture—for large specs
• CLI reference—every flag
• Plugins: OpenTelemetry
• Plugins: PostHog