> ## 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 (v1)

> Legacy Octolens MCP v1 setup. Connects Claude, ChatGPT, Cursor, and other AI agents to your Octolens mentions via a token-in-URL connection.

<Warning>
  **You're viewing the legacy MCP v1 docs.** v1 still works for existing connections, but it's no longer the default and receives no new features. New setups should use [MCP v2](/mcp/v2/overview) — OAuth instead of a token in the URL, plus feeds, analytics, and keyword/feed management. See the [migration steps](/mcp/v2/overview#migrating-from-v1).
</Warning>

**Octolens MCP** lets AI agents securely access your social listening data. MCP (Model Context Protocol) is a standard that allows AI tools to connect with third-party APIs in a secure, consistent way. In this case, MCP connects AI tools to your Octolens workspace, so you can query mentions, analyze conversations, and build custom reports from your existing monitoring data.

* "Generate a share of voice graph using my BRAND, COMPETITOR 1, COMPETITOR2, and COMPETITOR3, and include percentage share, mention volume, as well as sentiment breakdown"
* "Show me all Reddit mentions from the last week where sentiment is negative"
* "Analyze competitor positioning from recent Twitter conversations"
* "Generate a summary of feature requests from the last 7 days"

***

### How to Use Octolens MCP

In Octolens, navigate to Settings and then the MCP tab.

You will need to **generate your MCP URL** to connect your Octolens account and data to any of our supported AI tools.

* Click Generate URL
* Choose a name for your API key
* Choose an expiration date for your API key from the dropdown
* Click **Create**
* Copy the URL

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

<Frame>
  <img src="https://mintcdn.com/octolens/8iRWFpJ7a8eizFVd/images/mcp-generate-url.png?fit=max&auto=format&n=8iRWFpJ7a8eizFVd&q=85&s=4e2fb6f471cceabb7ebf50ff99e18615" alt="Generate MCP URL in Octolens settings" width="2148" height="1550" data-path="images/mcp-generate-url.png" />
</Frame>

***

### Setup Guides

Most popular AI tools support connecting to the remote MCP directly. Follow our step-by-step guides:

* [**Claude Code**](/mcp/setup-guides#claude-code)
* [**Claude Web / Desktop**](/mcp/setup-guides#claude-desktop--web)
* [**ChatGPT**](/mcp/setup-guides#chatgpt)
* [**Cursor**](/mcp/setup-guides#cursor)

***

### Terms of Use

The Octolens MCP server is intended for use with MCP-compatible AI clients (such as ChatGPT, Claude, and similar assistants) 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: [API documentation](/api/overview)