# Odiseo

Connects AI agents to the Odiseo SEO workspace for site auditing, content planning, and publishing. Useful for managing search optimization workflows directly in your editor.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: odiseohelp-app
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/odiseohelp-app/cli
- Updated: 2026-08-02
- HTML: https://affpapa.org/en/nevibecode/mcp/odiseo

## What it does

Odiseo brings search optimization capabilities to coding assistants. The server handles technical audits alongside publication workflows inside your workspace. Communication runs through a Streamable HTTP endpoint.

Setup relies on the `odiseo-cli` helper. You authenticate via browser OAuth or pass a dedicated `seoap_` token. Saved tokens go into `~/.config/odiseo/config.json` with `0600` permissions. The command `odiseo mcp doctor` tests latency and credential state.

Node.js 20 or newer is mandatory to run the CLI. You also need an Odiseo subscription with enabled MCP permissions.

## Requirements
- Remote server: `https://www.odiseo.help/api/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://www.odiseo.help/api/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add odiseo --url https://www.odiseo.help/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "odiseo": {
            "url": "https://www.odiseo.help/api/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "odiseo": {
            "type": "http",
            "url": "https://www.odiseo.help/api/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http odiseo https://www.odiseo.help/api/mcp
```

## When to use it
- audit site pages for search optimization issues
- generate content briefs and editorial plans
- review drafted articles against quality criteria
- trigger article publication into target systems

## Example prompts
- Generate a content brief for our upcoming blog release
- Audit the landing page layout for search engine visibility
- Review this draft article before pushing it to publication

## Similar
- [medium-posts](https://affpapa.org/en/nevibecode/skills/medium-posts.md) — skill · 2000 installs
- [wewrite-wechat-ai-publishing](https://affpapa.org/en/nevibecode/skills/wewrite-wechat-ai-publishing.md) — skill · 882 installs
- [Sightkick](https://affpapa.org/en/nevibecode/mcp/sightkick.md) — MCP server
- [youtube-publishing-and-metadata](https://affpapa.org/en/nevibecode/skills/youtube-publishing-and-metadata.md) — skill · 660 installs
- [geo-content-optimizer](https://affpapa.org/en/nevibecode/skills/geo-content-optimizer.md) — skill · 5300 installs
- [content-gap-analysis](https://affpapa.org/en/nevibecode/skills/content-gap-analysis.md) — skill · 5100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md