Octen Docs | The Search infrastructure for AI

Coding agents such as Claude Code and Cursor can build an Octen integration for you. This page gives an agent what it needs: what Octen offers, the docs in agent-friendly formats, how to connect to Octen, and how to use it in applications.

What Octen Offers

Octen is the search infrastructure for AI: a real-time web search foundation that lets LLMs, agents, and apps reason with the world’s latest information.

Product	What it does
Broad Search	Expands one query into multi-angle sub-queries and searches them concurrently.
Web Search	Live web search with ranked results, highlights, and optional full content.
Image Search (beta)	Image search by text or reference image; the design topic adds style summaries and HTML snippets.
Video Search (beta)	Video search from a text query, with rich metadata.
Extract	Turns up to 20 URLs into clean, LLM-ready markdown or text.
Model Gateway	Frontier models behind one API key, with built-in Octen search tools.
Embedding	Text embeddings for semantic search, RAG, and recommendations.
VL Embedding	Multimodal embeddings across text, images, and videos.
Answer	A question in, a synthesized answer with sources out.
Deep Research	Autonomous multi-round research that streams back a cited report.
Multimodal Chat (beta)	Replies with interleaved text, images, and videos, grounded in multimodal search.
Grounded Generation (beta)	Generates images and videos grounded in search results.

How to Read the Docs

Plain text pages

Add .md to the end of any docs URL to get the page as plain Markdown. For example, the Web Search API reference is available at https://docs.octen.ai/api-reference/search.md. This format beats scraping or copying the HTML pages:

Plain text contains fewer formatting tokens.
Content that isn’t rendered in the default view, such as content hidden in a tab, is included.
LLMs parse and understand Markdown hierarchy.

llms.txt

docs.octen.ai/llms.txt carries comprehensive API documentation designed for LLM consumption, following the llms.txt standard for making websites accessible to LLMs.

Connect to Octen

Connect to Octen with one command through Agent Skills, the MCP server, or the CLI.

You’ll need an Octen API key first. Create one from the API Platform.

Octen Skills

Agent skills for search, extract, and design references. One command, agent auto-detected:

npx skills add Octen-Team/octen-skills

Per-agent commands and API key setup are in Octen Skills.

Octen MCP Server

Search and extract tools for any MCP-compatible client. In Claude Code:

claude mcp add --scope user octen \
  -e OCTEN_API_KEY=your-key-here \
  -- npx -y octen-mcp

Configs for Claude Desktop, Cursor, VS Code, and other clients are in Octen MCP Server.

Octen CLI

The full Octen API in your terminal, plus one-command setup of the MCP server or Skills:

npm i -g @octen.ai/cli
octen configure-skills --claude-code --set-key

Commands and options are in Octen CLI.

Use in Applications

In application code, call the Octen API directly: the base URL is https://api.octen.ai, authenticated with the x-api-key header or a Bearer token.

curl -X POST https://api.octen.ai/search \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"query": "Tesla stock price"}'

from octen import Octen

client = Octen(api_key="your-api-key")  # or set OCTEN_API_KEY env var
results = client.search.search(query="Tesla stock price")

Every endpoint, parameter, and response schema is in the API Reference. For Model Gateway, existing OpenAI and Anthropic SDK code works after swapping the base URL and key; see Model Gateway.

​What Octen Offers

​How to Read the Docs

​Plain text pages

​llms.txt

​Connect to Octen

​Octen Skills

​Octen MCP Server

​Octen CLI

​Use in Applications

What Octen Offers

How to Read the Docs

Plain text pages

llms.txt

Connect to Octen

Octen Skills

Octen MCP Server

Octen CLI

Use in Applications