Engineering Guide
Instant Tool Creation: Importing OpenAPI Specs into AI Agents
RH
By Rakib Hasan
•
Published October 01, 2026
•
5 min read
Integrating private APIs into autonomous coding agents like Claude Code, Cursor, and Codex traditionally required handwriting JSON schemas, wrapping authentication, and constructing custom MCP servers. With olywork's native OpenAPI Importer, teams can convert any OpenAPI 3.0 or Swagger 2.0 specification into production-ready agent tools in seconds.
One-Command Spec Ingestion
Import an entire API documentation spec via the olywork CLI or dashboard UI:
$ olywork tool import-openapi \
--url https://api.example.com/openapi.json \
--auth-type bearer \
--secret-env EXAMPLE_API_KEY \
--price-micro 1000
[ok] Imported 14 endpoints into tool namespace "example-api"
[ok] Registered 0-markup credential proxy with SSRF validation
[ok] Generated SKILL.md for team agents
How the Importer Works
- Deterministic Schema Normalization: Resolves internal
$ref pointers, maps query and path parameters into JSON Schema definitions, and formats concise descriptions for LLM context windows.
- Zero-Trust Credential Security: Injects team API keys server-side during relay so local agents never hold raw tokens.
- Micro-USD Accounting: Automatically sets deterministic per-call pricing in integer micro-USD.
RH
Rakib Hasan
Software Engineer at Liberate Labs | AI Researcher |