@ruah-dev/conv
Converter
How do I make this API agent-sized?
Curate and convert massive API specifications into compact, agent-friendly tool surfaces. Compress 400-endpoint specs into 5–10 task-level MCP tools with minimal context overhead.
See it
@ruah-dev/conv
Quick start
Up and running in seconds
@ruah-dev/conv
$ ruah conv curate api.yaml
# 29 endpoints → 10 tools
# ~226 tok of definitions (was ~540)
$ ruah conv generate api.yaml --curate --jsonFeatures
015 input formats (OpenAPI 3.x, Swagger 2.0, Postman, GraphQL, HAR)
02Smart endpoint curation (collapses bloated APIs into task-level tools)
03MCP Tool Definitions & TypeScript/Python server scaffolds
04OpenAI & Anthropic Function Calling schema generation
05Context footprint & token cost calculator per toolset
06Single runtime dependency
5
Input formats
≤10
Curated tools
1
Dependency
Command Reference
Commands
ruah conv curate <spec>Interactively collapse endpoints into ≤10 task toolsruah conv generate <spec>Parse specification and generate target tool surfaceruah conv inspect <spec>Parse and display intermediate representation (IR) summaryruah conv validate <spec>Validate API spec against best practices for agentsruah conv targetsList all supported output surface targetsInput
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 Router
@ruah-dev/cli
One command. Every agent tool.
Guard
@ruah-dev/guard
Can I trust the agent not to do damage — in any harness, with proof?
Verify
@ruah-dev/verify
Did the agent actually finish?
Optimizer
@ruah-dev/opt
Where did my tokens go?
Watch (Lite)
@ruah-dev/watch
Can I show someone what this session did?
Eval
@ruah-dev/eval
Same task — which executor wins, and what did it cost?
Orchestrator
@ruah-dev/orch
Parallel agents. Zero collisions.