# Octri CLI

> Octri CLI is a freemium MCP server for developer tools. Push OpenAPI specs, build SDKs, publish docs and triage SDK errors from an agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** CLI, API, Web
- **Website:** https://octri.dev
- **Repository:** https://github.com/octridev/octri-cli
- **MCP Registry name:** dev.octri/cli
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

This server exposes the Octri command line over stdio, so an agent can run the same steps as the dashboard. The README walks through pushing a spec (the call waits for the whole pipeline, not just upload), auditing and building SDKs, publishing docs versions, managing redirects, navigation and custom components, and reading monitoring issues with source-map resolution.

Octri itself turns an OpenAPI, Swagger, Postman or AsyncAPI file into a documentation site, SDKs in ten languages (TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Swift, Dart, Rust), an MCP server and monitoring. SDK builds show progress per language and exit non-zero on failure in CI.

The npm package needs Node 20 or newer and can authenticate with OCTRI_API_KEY or a prior octri auth login. Optional variables select the project, profile and an HTTPS proxy. The Free plan caps 1 project, 1 SDK language, 50 endpoints and 100 MB of monitoring a month.

## Features

- **Spec push:** Uploads a spec and waits for docs, search index and changelog to be written.
- **SDK build and audit:** Builds SDKs per language and scores the spec for generator-fixable issues.
- **Docs publishing:** Publishes versions, custom domains, redirects, navigation and components.
- **Monitoring triage:** Lists unresolved issues and resolves them, with source-map frame resolution.
- **Proxy and profile support:** Environment variables select the project, stored profile and an HTTPS proxy.

## Good for

- Push an updated OpenAPI file and publish the docs
- Generate Go and TypeScript SDKs in a CI step
- Find which release is missing source maps
- Triage production SDK errors from an assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add cli --env OCTRI_API_KEY='<OCTRI_API_KEY>' --env HTTPS_PROXY='<HTTPS_PROXY>' -- npx -y @octri/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "@octri/cli"
      ],
      "env": {
        "OCTRI_API_KEY": "<OCTRI_API_KEY>",
        "HTTPS_PROXY": "<HTTPS_PROXY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "@octri/cli"
      ],
      "env": {
        "OCTRI_API_KEY": "<OCTRI_API_KEY>",
        "HTTPS_PROXY": "<HTTPS_PROXY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@octri/cli"
      ],
      "env": {
        "OCTRI_API_KEY": "<OCTRI_API_KEY>",
        "HTTPS_PROXY": "<HTTPS_PROXY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "@octri/cli"
      ],
      "env": {
        "OCTRI_API_KEY": "<OCTRI_API_KEY>",
        "HTTPS_PROXY": "<HTTPS_PROXY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "@octri/cli"
      ],
      "env": {
        "OCTRI_API_KEY": "<OCTRI_API_KEY>",
        "HTTPS_PROXY": "<HTTPS_PROXY>"
      }
    }
  }
}
```

## FAQ

### How does it authenticate?

With OCTRI_API_KEY, or the session from octri auth login.

### What are the plan prices?

Free is $0; Starter $49, Growth $79 and Business $249 per month; Enterprise is custom.

### Which SDK languages are supported?

TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Swift, Dart and Rust.

### What does Free cap?

1 project, 1 SDK language, 50 endpoints and 100 MB of monitoring a month.

### Is Octri CLI free?

Octri CLI has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Octri CLI to Claude Code?

Run this command in your terminal: claude mcp add cli --env OCTRI_API_KEY='<OCTRI_API_KEY>' --env HTTPS_PROXY='<HTTPS_PROXY>' -- npx -y @octri/cli

### What are the best alternatives to Octri CLI?

The closest alternatives to Octri CLI are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/octri-cli
