> ## Documentation Index
> Fetch the complete documentation index at: https://octolens.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Connect Claude, ChatGPT, Cursor, and other AI assistants to your Octolens workspace. Ask about your mentions, run analytics, and manage keywords and feeds in plain language.

**Octolens MCP** lets AI assistants like Claude, ChatGPT, and Cursor access your Octolens workspace directly. Ask questions in plain language, and your assistant browses mentions, filters by source or sentiment, runs analytics, and manages your keywords and feeds for you.

Agents can already see inside your company: your code, tickets, and CRM. Octolens gives them ears for what customers say outside it.

MCP (Model Context Protocol) is an open standard that connects AI tools to third-party services in a secure, consistent way.

<Note>
  For shell scripts, CI pipelines, and bulk export, the [Octolens CLI](/docs/cli/overview) is often the better surface — same data, stable exit codes, and a strict `--json` contract built for automation.
</Note>

* "Generate a share of voice graph using my BRAND, COMPETITOR 1, and COMPETITOR 2, with percentage share, mention volume, and sentiment breakdown."
* "Show me all Reddit mentions from the last week where sentiment is negative."
* "Add 'next.js deployment' as a new keyword and route buy-intent mentions to my #leads Slack channel."
* "Summarize the feature requests from the last 7 days."

***

## What your assistant can do

Your AI assistant gets the **full Octolens surface**: every action available in the app is available to it.

**Reads:** mentions, keywords, feeds, tags, keyword suggestions, keyword health, workspace and company profile, usage, and global filters, plus analytics, one-time searches and CSV exports.

**Writes:** create and manage keywords and feeds, including wiring up Slack, email, and webhook notification destinations.

***

## Authentication

Octolens uses **OAuth**, so there's no API key or token to paste. On first use, your AI client opens a browser tab, you sign in to Octolens and approve the connection, and you're ready. Your token never lives in a URL or config file.

#### Connection URL

```text theme={null}
https://app.octolens.com/api/mcp/v2
```

Add this URL in your AI client and complete the OAuth sign-in. Step-by-step instructions for each tool are in [Setup guides](#setup-guides) below.

<Note>
  MCP is intended for interactive AI-client workflows. For scripts, backend jobs, or production integrations, use the [REST API](/docs/api/v2/overview).
</Note>

***

## Setup guides

Most popular AI tools connect to the remote MCP server directly. Each one has its own guide under AI Assistants:

* [**Claude Code**](/docs/ai-assistants/claude-code)
* [**Claude Desktop & Web**](/docs/ai-assistants/claude-desktop)
* [**ChatGPT**](/docs/ai-assistants/chatgpt)
* [**Cursor**](/docs/ai-assistants/cursor)

You can also generate setup snippets from inside the app under **Settings → MCP**, and try the server live in the **Playground**.

***

## Tools

The server has more than 40 tools across mentions, keywords, feeds, tags, suggestions, workspace, usage, and analytics. See the full [Tools Reference](/docs/mcp/v2/tools) for what each one does and when your assistant will reach for it.

For ready-to-paste prompts and workflows, see [Use Cases](/docs/mcp/v2/use-cases).

***

## Security: mentions are untrusted content

Every mention Octolens delivers was written by an unknown third party somewhere on the internet. When your AI assistant reads mentions through this MCP server, that content is **data, not instructions** — a post could contain text deliberately crafted to steer an AI agent ("prompt injection").

Octolens scores mentions for relevance and sentiment, but does not remove or neutralize adversarial text.

Practical guidance:

* Be deliberate about combining Octolens with write-capable tools (email, code, payments, file access) in the same agent session. Prefer read-only sessions when browsing mentions.
* If your agent acts on mentions automatically, gate consequential actions behind a confirmation step.
* Tell your agent explicitly that mention text is quoted third-party content and never a source of instructions.

***

## Terms of Use

The Octolens MCP server is intended for use with MCP-compatible AI clients (such as ChatGPT, Claude, and Cursor) for interactive, AI-driven workflows.

**Not permitted:** Using the MCP endpoint via custom scripts, bridges, or standalone HTTP/JSON-RPC clients is unsupported and not permitted. The MCP server is not a general-purpose programmatic API.

**For programmatic access:** Use the Octolens API instead — see the [API documentation](/docs/api/v2/overview).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.