Specification normalization
Import OpenAPI 3.0 or 3.1, Swagger 2.0, Postman, or AsyncAPI files in JSON or YAML, then normalize them to OpenAPI 3.1 for downstream products.
Octri
Octri turns OpenAPI, Swagger, Postman, or AsyncAPI specifications into editable API documentation, configurable SDKs in ten languages, MCP tools, and production monitoring. It is intended for teams that want these API delivery and observability workflows connected to one source specification.
API tooling from one specification
Octri is a developer platform that takes an API specification through documentation, SDK generation, agent access, and production monitoring. It accepts several common API description formats, normalizes them to OpenAPI 3.1, and uses the resulting model to produce a documentation site, client libraries, an MCP server, and telemetry workflows.
The platform is designed to keep these outputs connected to the source specification. Teams can edit generated reference content, write separate guides, configure clients for their conventions, and rebuild after a merged specification change. Monitoring can be compiled into generated SDKs or added to a backend separately, so teams can inspect errors, traces, service relationships, uptime, and regressions without deploying a monitoring agent.
Core capabilities
API documentation studio
Generate searchable reference pages, edit them in place, add MDX or visual guides, and publish the result on a custom domain. Documentation updates can be rebuilt from a changed specification.
Interactive documentation
Provide a live, schema-driven console that sends real requests using the API's authentication and produces snippets from the reader's input. Search and optional AI chat help readers locate answers.
Configurable SDK generation
Generate idiomatic client libraries for ten named languages, with per-language settings for naming, pagination, idempotency, code style, transport, and project structure. Clients can be published to package registries.
SDK and API monitoring
Add telemetry to generated SDKs or use a standalone backend package without deploying an agent. Monitoring provides structured logs, grouped issues, traces, service maps, N+1 query detection, synthetic uptime checks, and alerts.
Agent-readable API access
Publish the documentation as markdown and through llms.txt, and expose API endpoints as callable tools for Claude, Cursor, and other MCP clients. Machine-readable access can be disabled from the site settings.
Practical use cases
Publishing usable API reference
Import an existing API specification, generate reference pages for its endpoints, then correct descriptions, add examples, and publish a reader-facing site without requiring readers to work directly from the source YAML.
Maintaining client libraries
Configure naming, pagination, idempotency, transport, and folder conventions for each target language, then publish generated clients to package registries and review build history when changes ship.
Making an API usable by agents
Expose the same API documentation as rendered pages, markdown, and an llms.txt index, while allowing MCP clients such as Claude or Cursor to call documented endpoints as tools.
Investigating production API failures
Compile telemetry into generated SDKs or install the backend package, then investigate a customer-reported failure through grouped issues, traces, service maps, query detection, uptime checks, and alerts.
Pros and Cons
Pros
- One specification can drive documentation, SDKs, MCP tools, and monitoring workflows.
- Generated documentation remains editable, with manual edits preserved across later regeneration unless removed.
- The documentation site combines reference pages, guides, search, a live request console, and machine-readable content.
- SDK output supports ten languages and per-language conventions instead of requiring teams to fork generated clients.
- Monitoring can be included in generated SDKs or added to an existing backend package, with client-side and ingest-time redaction described by the product.
Cons
- The most detailed workflow and configuration information is centered on API documentation, SDK generation, MCP access, and monitoring; teams with requirements outside those areas may need to validate fit.
- AI documentation and chat use credits, and SDK language allowances vary by plan; additional languages are paid add-ons on some tiers.
- Customer-managed deployment for the generator and documentation renderer is limited to Enterprise plans.
FAQ
What specification formats does Octri support?
Octri accepts OpenAPI 3.0 and 3.1, Swagger 2.0, Postman, and AsyncAPI specifications in JSON or YAML. It normalizes the input to OpenAPI 3.1. You can provide a base URL and authentication scheme through the specification, where supported.
How does Octri handle generated documentation and edits?
The documentation generator creates reference pages for the paths and methods in a specification. You can generate the whole API, only undocumented gaps, or an individual page. Generated content can be edited in place before publishing, and your edits remain in place during later runs unless you explicitly remove them.
What does an Octri documentation site include?
The published site includes API reference pages, guides, search, a live playground, and an agent-readable index. Reference pages can include endpoint explanations, field descriptions, status-specific error guidance, runnable cURL, JavaScript, and Python examples, plus deprecation indicators.
Which SDK languages and configuration options are available?
SDK Studio generates clients for TypeScript, Python, Go, Java, Dart, Ruby, PHP, Rust, Swift, and Kotlin. It supports per-language configuration such as namespaces, pagination, idempotency, code style, HTTP engine, method names, excluded endpoints, and folder structure. Custom hooks can be compiled into the clients.
Is Octri hosted, and is there a free plan?
Octri has a free tier and paid plans. One plan covers documentation, SDKs, monitoring, and the MCP server, while the available volume and SDK language allowance vary by tier. Enterprise plans can run the generator and documentation renderer in a customer-managed infrastructure; other tiers are hosted by Octri.
Quick Facts
- Category
- Developer tool
- Primary input
- OpenAPI, Swagger, Postman, or AsyncAPI in JSON or YAML
- Generated outputs
- Documentation, SDKs, MCP server, and monitoring workflows
- SDK languages
- TypeScript, Python, Go, Java, Dart, Ruby, PHP, Rust, Swift, and Kotlin
- Documentation hosting
- Hosted custom-domain sites; customer-managed renderer available on Enterprise
- Pricing model
- Free tier plus paid plans; one plan covers docs, SDKs, monitoring, and MCP
Alternativas ao Octri
ByteAsk
ByteAsk is a terminal-first AI coding agent for C and C++ that edits repositories and verifies changes with the real compiler, debugger, sanitizers, and tests before showing a diff. It offers a free tier plus paid plans, with editor connectors and zero-retention handling described in the source.
CreateOS Sandbox
CreateOS Sandbox is an isolated compute environment for running code and agent workloads inside Firecracker micro-VMs. It is designed for workflows that need machine-level isolation, private networking between sandboxes, and programmatic control through SDK, CLI, or MCP.
GitBot
GitBot is a local browser-based workspace for creating reusable coding bots powered by Claude Code, Codex, or OpenCode. It helps developers run those agents across repository folders with persistent threads and configurable permissions.
hob
hob is an independent workspace for coding agents that keeps agent sessions, terminals, history, and follow-up work organized around the tools and providers you already use. It is aimed at developers who want local control over routing, history, and workspace structure rather than a bundled model stack.
Ably Chat
Ably Chat is a chat API platform for building custom realtime chat applications. It supports room-based messaging, typing indicators, presence, reactions, and message updates, with usage-based pricing options for different deployment stages.
Manta AI
Manta AI is an autonomous web app testing tool for teams that want to map application behavior, catch regressions, and generate tests without writing scripts or maintaining selectors. It works from a URL and supports plain-English test flows, run results with screenshots, and scheduled or deployment-triggered checks.