@ruah-dev/conv

Converter

Any spec. Agent-ready tools.

Convert API specs into agent-ready tool surfaces. Feed it an OpenAPI spec, get MCP tool definitions, function-calling schemas, or a full MCP server scaffold.

Source

See it

@ruah-dev/conv
ruah-conv — inspect, validate, and generate MCP tool definitions from API specs

Quick start

Up and running in seconds

@ruah-dev/conv
$ ruah conv generate api.yaml \
    --target mcp-server \
    --language typescript

# ✓ Parsed: 24 endpoints
# ✓ Classified: 8 safe, 12 moderate, 4 destructive
# ✓ Generated: src/mcp-server/
#   → 24 tool definitions
#   → Type-safe schemas
#   → Ready to serve

Features

01OpenAPI, Swagger, Postman, GraphQL, HAR input
02MCP, OpenAI, Anthropic, A2A output
03Risk classification (safe/moderate/destructive)
04TypeScript & Python server scaffolds
05Intermediate representation (Ruah Tool Schema)
06Single runtime dependency

5

Input formats

6

Output targets

1

Dependency

Command Reference

Commands

ruah conv generateParse spec and generate output
ruah conv inspectParse and display IR summary
ruah conv validateCheck spec for issues
ruah conv targetsList available output targets

Input

Supported formats

OpenAPI 3.x
Swagger 2.0
Postman v2.1
GraphQL SDL
HAR

Output

Target surfaces

MCP Tool Definitions
MCP Server (TypeScript)
MCP Server (Python)
OpenAI Function Calling
Anthropic Function Calling
A2A Service

Ecosystem

Part of the ruah toolchain

CLI

@ruah-dev/cli

One command. Every tool.

Orchestrator

@ruah-dev/orch

Parallel agents. Zero collisions.

Dive deeper

Full API reference, guides, and examples.

Read the docs