Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Octen MCP

by Octen-Teamversion 0.1.5i★ 25iRuns on your computerRepository ↗
Registry nameio.github.Octen-Team/octen-mcp

How to install

What it does

URL to LLM-ready markdown — plus per-page category, page_structure, and query-driven highlights.

  • Connects Runs on your computer
  • Account or key Needs OCTEN_API_KEY
  • Category Docs, sheets & office work

Use together with

Skills that teach the AI this kind of work; they work alongside this one

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

by opendatalab★ 83,9721 skills

Skill · How-to guideNo license stated

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

by guillaumemeyer★ 27,7961 skills

Skill · How-to guide

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

by kepano★ 53,183 (whole repo)5 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity17/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score29/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Octen MCP. Follow https://mcp.popnx.com/i/octen-team-octen-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a Octen MCP key (create it on the maker’s site) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Octen MCP for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "octen": { "command": "npx", "args": [ "-y", "octen-mcp" ], "env": { "OCTEN_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For OCTEN_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Octen MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Octen MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  4. Paste these settings and save the file

    {
      "mcpServers": {
        "octen": {
          "command": "npx",
          "args": [
            "-y",
            "octen-mcp"
          ],
          "env": {
            "OCTEN_API_KEY": "your-value"
          }
        }
      }
    }

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Quit Claude and open it again

  6. Try it

    Use Octen MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Octen MCP or shows a Octen MCP tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • OCTEN_API_URL Override the Octen API base URL. Default: https://api.octen.ai. · default https://api.octen.ai

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Octen MCP yet

Octen MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Octen MCP

  • You need a Octen MCP key (create it on the maker’s site) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a Octen MCP key (create it on the maker’s site) · Install Node.js on your computer first (one time)
  • You need a Octen MCP key (create it on the maker’s site) · Install Node.js on your computer first (one time)
  • You need a Octen MCP key (create it on the maker’s site) · Install Node.js on your computer first (one time)

B · Others in Docs, sheets & office work that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a Octen MCP key (create it on the maker’s site) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Octen MCP for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user octen --env OCTEN_API_KEY=your-value -- npx -y octen-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For OCTEN_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Octen MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Octen MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  4. Paste this command and press Enter

    claude mcp add --scope user octen --env OCTEN_API_KEY=your-value -- npx -y octen-mcp

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Type /mcp in Claude Code

    You should see Octen MCP listed as connected

  6. Try it

    Use Octen MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Octen MCP or shows a Octen MCP tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • OCTEN_API_URL Override the Octen API base URL. Default: https://api.octen.ai. · default https://api.octen.ai

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Octen MCP key (create it on the maker’s site) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Octen MCP for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "octen": { "command": "npx", "args": [ "-y", "octen-mcp" ], "env": { "OCTEN_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For OCTEN_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Octen MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Octen MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  4. Fill in your key

    In the Octen MCP settings, OCTEN_API_KEY is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in Cursor in Agent mode

  6. Try it

    Use Octen MCP and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Octen MCP or shows a Octen MCP tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • OCTEN_API_URL Override the Octen API base URL. Default: https://api.octen.ai. · default https://api.octen.ai

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Octen MCP key (create it on the maker’s site) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Octen MCP for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "octen": { "type": "stdio", "command": "npx", "args": [ "-y", "octen-mcp" ], "env": { "OCTEN_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For OCTEN_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Octen MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Octen MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  4. Fill in your key

    In the Octen MCP settings, OCTEN_API_KEY is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  5. Open the AI chat in VS Code in Agent mode

  6. Try it

    Use Octen MCP and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Octen MCP or shows a Octen MCP tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • OCTEN_API_URL Override the Octen API base URL. Default: https://api.octen.ai. · default https://api.octen.ai

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Octen MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user octen --env OCTEN_API_KEY=your-value -- npx -y octen-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "octen": {
      "command": "npx",
      "args": [
        "-y",
        "octen-mcp"
      ],
      "env": {
        "OCTEN_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "octen": {
      "command": "npx",
      "args": [
        "-y",
        "octen-mcp"
      ],
      "env": {
        "OCTEN_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "octen": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "octen-mcp"
      ],
      "env": {
        "OCTEN_API_KEY": "your-value"
      }
    }
  }
}

Values you fill in

  • OCTEN_API_KEY secret required env
    Octen API key. Get one at https://octen.ai (self-serve).
  • OCTEN_API_URL env
    Override the Octen API base URL. Default: https://api.octen.ai.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
243/wk
Connection
Runs on your computer
Latest versioni
0.1.5
Published to registryi
May 20, 2026
Code last changedi
Nov 11, 2026
Maker
Octen-Team
Packages
npm: octen-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account Octen-Team, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 8 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for octen-mcp@0.1.5

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/octen-team-octen-mcp.svg)](https://mcp.popnx.com/en/servers/octen-team-octen-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Docs, sheets & office worki

  • More stars than 96% of the other 4155 servers in this category
  • Published to the registry more recently than 8% of the other 4155 servers in this category
  • Basic checks equal to or better than 99% of the other 4155 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Octen MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: OCTEN_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 8 days ago, and the latest version (0.1.5) reached the registry 6 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

by HeyPuterWidely used★ 44.2KUpdated 5 months ago

Runs in the cloud✓ service owner · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

by getsentryWidely used↓ 130.5K/wk shared package★ 6.6KUpdated 4 months ago

Runs on your computer✓ service owner · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

by Vexa-aiWidely used★ 3KUpdated 2 months ago

Runs in the cloud✓ service owner · vexa.ai

Atlassian Rovo MCP Server

Atlassian’s official server lets AI search and manage Jira work and Confluence pages. Connects to Atlassian’s cloud with OAuth sign-in.

by atlassianGrowing★ 1.2KUpdated 2 months ago

Runs in the cloud✓ service owner · atlassian.com

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

by ankimcpGrowing↓ 1.1K/wk★ 568Updated last month

Runs on your computer✓ service owner · ankimcp.ai
Compared with similar ones
This one
Octen MCP
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
Runs whereInstalls on your computerRuns in the cloud, nothing to installInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installInstalls on your computer
Needs a keyYesNoNoYesNoNo
Add with + in ClaudeNoNoNoNoYesNo
Basic checks3/34/43/32/44/43/3
LicenseMITAGPL-3.0MITApache-2.0Apache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

octen-mcp

MCP server for Octen. Plug it into Claude, Cursor, VS Code, Windsurf, or any MCP client to give your agent live web search and URL extraction.

Core capabilities:

  • `search`: search the live web with domain, text, language, and time filters.
  • `news_search`: recent news, returned both as articles and as storylines — the coverage grouped into subjects, each with a summary and the span it covers.
  • `pulse_search`: the URL a query most likely means, in about 10ms — official docs, help centres, a site you could almost name. No freshness, no filters.
  • `place_search`: real-world places as structured cards — address, coordinates, phone, opening hours, rating — around a point you give it, or in an area the query names.
  • `business_search`: a company or person, returned as a structured card — profile, financials, key people, career history, recent announcements — alongside the sources behind it.
  • `broad_search`: decompose a query into multiple sub-queries, search them concurrently, and return results grouped per sub-query for broad coverage.
  • `extract`: turn one or more URLs into clean, LLM-ready content.
  • `image_search`: search the web for images by text query, by a reference image URL, or by base64 image data — exactly one of the three.
  • `video_search` (In Beta — contact us for beta access): search the web for videos by text query.

What makes Octen useful for agents is that extract returns more than page text. Each successful result also includes:

  • `category`: what the page is about
  • `page_structure`: what kind of page it is
  • `highlights`: ranked snippets when you pass a query

That lets an agent skip login walls, nav pages, and off-topic URLs before spending tokens on the full body.

Why Octen MCP

Fast

Web search averages 62ms. Fast enough for multi-step MCP workflows.

Accurate

Powered by SOTA text and VL embedding models. Better sources, fewer hallucinations.

Fresh

Live web data with minute-level updates. Useful for news, prices, and fast-moving pages.

Efficient

Clean highlights, optional full_content, and page labels keep model context relevant.

Pricing

Octen bills per call by default: $1 per 1,000 web searches, and new accounts start with $5 in credit.

If your agent searches a lot, Search Plan is a flat monthly subscription with no overage fees:

StandardPlus
Price$20 / month$100 / month
Web Search (search)UnlimitedUnlimited
Image Search (image_search)1,000 / month5,000 / month
Priority at peak times–✓

What each tool costs on a plan:

ToolOn Search Plan
searchIncluded, unlimited
image_searchIncluded up to the monthly quota, then pay-as-you-go
news_search, pulse_search, broad_search, place_search, business_search, extract, video_searchPay-as-you-go, billed per call

Once you subscribe, every API key on your account uses the plan, including keys issued through OAuth sign-in.

Subscribe at octen.ai/pricing.

Quick start

You need an OCTEN_API_KEY from octen.ai — or nothing at all, if your client signs in over OAuth (see Signing in instead).

Two ways to connect. Both serve the same nine tools.

EndpointWhen
Hosted (recommended)https://mcp.octen.ai/mcpNothing to install or update. Works with any client that speaks remote MCP.
Localnpx -y octen-mcpClients without remote support, air-gapped setups, or when you want the process on your own machine.

Node compatibility (local only): 0.4.2 and later run on every supported

Node (>= 18.17), including Node 26+. Versions 0.4.1 and below fail every call

on hosts whose embedded undici is v8+ (Node 26 and later) with

Network error … code=UND_ERR_INVALID_ARG cause=invalid onError method — if

you see that error, upgrade the package (or run on Node <= 24).

Connect to the hosted endpoint

Passing your key

Three ways, tried in this order. Prefer a header — a key in a URL is exposed to proxy logs, browser history and Referer headers.

FormUse when
x-api-key: The default.
Authorization: Bearer Your client only offers one header field.
?octenApiKey= appended to the URLYour client accepts nothing but a URL.

Or use OAuth and paste no key at all — see Signing in instead.

By client

Claude Code — install the plugin. It brings the hosted server together with two skills, octen-web-search (routes a request to the right tool) and octen-research (multi-source research pipeline):

claude plugin marketplace add Octen-Team/octen-mcp

claude plugin install octen@octen

Or from inside a session: /plugin marketplace add Octen-Team/octen-mcp, then /plugin install octen@octen.

The plugin carries no credential. The first call is answered 401 and Claude Code walks you through the OAuth sign-in — run /mcp if you want to start it yourself. To register the server on its own instead, with a key:

claude mcp add --transport http octen https://mcp.octen.ai/mcp --header "x-api-key: your-key-here"

Cursor — clone this repository into Cursor's local plugin directory to get the hosted server and both skills in one step:

git clone https://github.com/Octen-Team/octen-mcp ~/.cursor/plugins/local/octen

A Cursor Marketplace listing is pending review; this section will point at it once it is live. To wire up only the server, add it to ~/.cursor/mcp.json:

{

"mcpServers": { "octen": { "url": "https://mcp.octen.ai/mcp", "headers": { "x-api-key": "your-key-here" } } } }

VS Code — .vscode/mcp.json (workspace) or the user config. Note servers, not mcpServers, and the explicit type:

{

"servers": { "octen": { "type": "http", "url": "https://mcp.octen.ai/mcp", "headers": { "x-api-key": "your-key-here" } } } }

Codex

codex mcp add octen --url https://mcp.octen.ai/mcp --header "x-api-key: your-key-here"

Windsurf / Devin Desktop — ~/.config/devin/mcp_config.json on macOS and Linux ($XDG_CONFIG_HOME/devin/ when that is set), %APPDATA%\devin\mcp_config.json on Windows. Cascade accepts either serverUrl or url for a remote server; ~/.codeium/windsurf/mcp_config.json is the path for the legacy agent:

{

"mcpServers": { "octen": { "serverUrl": "https://mcp.octen.ai/mcp", "headers": { "x-api-key": "your-key-here" } } } }

Gemini CLI — ~/.gemini/settings.json. The key is httpUrl:

{

"mcpServers": { "octen": { "httpUrl": "https://mcp.octen.ai/mcp", "headers": { "x-api-key": "your-key-here" } } } }

Claude Desktop takes the URL directly — no config file, no bridge. In Settings → Connectors, click Add custom connector, name it Octen, and enter:

https://mcp.octen.ai/mcp

Leave the Advanced settings empty: the OAuth Client ID and Secret fields are for servers that cannot register a client on their own, and ours can. Claude will offer to sign you in, and an Octen key is issued to that connection when you approve.

The connector dialog has no field for request headers, so an API key goes in the URL instead:

https://mcp.octen.ai/mcp?octenApiKey=your-key-here

Signing in is the better of the two — a URL is not a secret-carrying medium, and the sign-in flow can be revoked from your account without editing anything on this side. Note also that Claude connects from Anthropic's servers rather than from your machine, so a self-hosted deployment has to be reachable from the public internet for this to work at all; a private one wants the bridge below.

Zed, Warp, Raycast, and Cline all connect to a remote server directly — point them at the endpoint and sign in. Raycast's HTTP transport offers an OAuth type of *Dynamic*, which is the one to pick: this server supports dynamic client registration, so there is no client ID to arrange.

{

"mcpServers": { "octen": { "url": "https://mcp.octen.ai/mcp" } } }

A client with no field for headers takes the key in the URL instead: https://mcp.octen.ai/mcp?octenApiKey=your-key-here.

Only for a client that still cannot reach a remote server at all, the mcp-remote bridge runs locally and forwards each request. Note there is no space after the colon in --header — the value is split on the first one:

{

"mcpServers": { "octen": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.octen.ai/mcp", "--header", "x-api-key:your-key-here" ] } } }

Signing in instead

If the deployment is configured with an authorization server — the hosted one is — a request with no credential is answered 401 + WWW-Authenticate: Bearer resource_metadata="…". That is the signal MCP clients use to start an OAuth flow, so a client that supports OAuth will offer to sign you in rather than ask for a key.

To move a connection that already has a key onto OAuth, point it at https://mcp.octen.ai/mcp/oauth (or append ?login). That path issues the challenge even when a key is present, which is the only way to trigger the switch — with a key attached, the ordinary endpoint has no reason to.

Loading fewer tools

?tools=search,extract limits a connection to the tools you name, for both tools/list and tools/call:

https://mcp.octen.ai/mcp?tools=search,extract

Clients load every advertised tool's full schema into the model's context, so narrowing the set is a real saving when you only need one or two. An unknown name is refused with a 400 listing the valid ones, rather than a connection that quietly comes up short.

Run it locally instead

{

"mcpServers": { "octen": { "command": "npx", "args": ["-y", "octen-mcp"], "env": { "OCTEN_API_KEY": "your-key-here" } } } }

AgentOne-line install
Claude Codeclaude mcp add --scope user octen -e OCTEN_API_KEY=your-key-here -- npx -y octen-mcp
Codexcodex mcp add octen --env OCTEN_API_KEY=your-key-here -- npx -y octen-mcp
Gemini CLIgemini mcp add octen -e OCTEN_API_KEY=your-key-here -- npx -y octen-mcp

| VS Code | `c

Only the beginning is shown; read the rest in the repo