Octolens MCP Server

Your mentions,one prompt away

Connect Octolens to Claude, Cursor, or ChatGPT and work with your social listening data in natural language — query mentions, run analytics, and manage keywords across 15+ platforms without leaving your AI tool.

OAuth sign-in • No API key • Available on all plans

Connect in one command/api/mcp/v2

claude mcp add --transport http octolens \

"https://app.octolens.com/api/mcp/v2"

# First call opens a browser sign-in.

# No API key. That's the whole setup.

Then just askconnected

> What are people saying about us on Reddit this week?

⏺ octolens · list_mentions

⏺ octolens · analytics

Found 47 mentions — 81% positive. Top thread…

Trusted by brands people talk about online

Octolens MCP

Query your mentions from any AI tool

Connect Octolens as an MCP server and ask questions about your mentions in natural language — directly from Claude, Cursor, or any MCP-compatible tool.

octolens-mcp

Try asking Octolens:

Ask @octolens anything...

Works with your favorite AI tools

Claude CodeClaude DesktopClaude WebChatGPTCursor

Connect your AI to social data

Why MCP

Social listening where you already work

Octolens MCP connects your mentions, analytics, and workspace settings to Claude, Cursor, ChatGPT, and any MCP-compatible tool — no context-switching, no exports.

Your data, in natural language

Skip the dashboard tab. Ask for mentions by platform, sentiment, or keyword — or have your assistant run SQL analytics for trends and share-of-voice — right where you already work.

One-click OAuth, zero keys

Connect the server and sign in via the browser on first use. No API key to create, paste into configs, or rotate — and no platform credentials to manage, ever.

Read and write

9 of the 23 tools manage your workspace: add and tune keywords, build feeds, and wire Slack, email, or webhook alerts — all from a conversation.

MCP for chat, REST for code

MCP is built for interactive AI workflows. For scripts, backend jobs, and pipelines, the same data is available via our social listening API.

Explore the API →

Setup

Connected in under a minute

Point your AI tool at the server URL and sign in with your Octolens account. OAuth handles the rest — there's no API key to create, paste, or rotate.

claude mcp add --transport http octolens \
  "https://app.octolens.com/api/mcp/v2"

# Then inside Claude Code:
/mcp
# → octolens → Authenticate (opens browser sign-in)

Run the command, then type /mcp inside Claude Code and pick octolens → Authenticate. A browser tab opens — sign in to Octolens and you're connected.

Reference

23 tools, the full Octolens surface

Everything you can do in the dashboard, your AI assistant can do too — read mentions and analytics, and manage keywords, feeds, and alert destinations.

Tool	What it does	Access
Mentions & Analytics
list_mentions	Fetch collected mentions with filtering and pagination	Read
analytics	Run read-only SQL queries against mentions for aggregations and trends	Read
analytics_context	Get the analytics schema and valid filter values	Read
Keywords
list_keywords	List every monitored keyword with IDs, platforms, tag, and status	Read
get_keyword	Retrieve one keyword's full configuration by ID	Read
add_keyword	Start monitoring a new phrase	Write
update_keyword	Modify a keyword's platforms, exclusions, context, or tag	Write
pause_keyword	Suspend or resume collection for a keyword without deletion	Write
delete_keyword	Permanently remove a keyword	Write
list_keyword_suggestions	List AI-proposed keyword tweaks awaiting review	Read
accept_keyword_suggestion	Approve a pending keyword suggestion	Write
reject_keyword_suggestion	Decline a pending keyword suggestion	Write
Feeds & Destinations
list_feeds	List saved feeds with their filters and destinations	Read
create_feed	Build a feed with filters and optional notification destinations	Write
update_feed	Change a feed's name, icon, or filter criteria	Write
delete_feed	Permanently delete a feed	Write
add_feed_destination	Attach an email, Slack, or webhook destination to a feed	Write
remove_feed_destination	Detach a destination from a feed	Write
search_slack_channels	Resolve a Slack channel name to the channel ID	Read
Workspace & Usage
get_workspace	Return workspace context and the monitored company profile	Read
get_usage	Show current usage against plan limits	Read
get_global_filters	Retrieve workspace-wide filters applied across all queries	Read
list_tags	List valid tag values (AI-assigned topical labels) for filtering	Read

Full parameter docs at octolens.com/docs/mcp/v2

Platforms

Monitor socials & the web with one API

Octolens monitors 100s of millions of mentions every day for SaaS and developer brands — across social platforms, news, podcasts, and more.

DEV

Finally, social listening with fair pricing

Pay MonthlyPay AnnuallySave up to 20%

Not sure which plan? Try our pricing calculator →

Pro

$159/month

Billed annually

React faster & integrate with your workflows
✓15,000 mentions
✓10 keywords
✓Covers all socials & community platforms
✓Hourly refresh
✓API, Webhooks & MCP server
✓Slack & Email alerts
✓AI filters all mentions

For growing brands

Scale

$499/month

Billed annually

Full visibility into your brand's reputation
✓50,000 mentions
✓40 keywords
✓Additionally covers podcasts, news, web & newsletters
✓Real-time refresh
✓API, Webhooks & MCP server
✓Slack & Email alerts
✓AI filters all mentions

For brands with communities

Enterprise

Custom

Custom monitoring for multi-brand portfolios
✓Multiple workspaces
✓Unlimited mentions
✓Unlimited keywords
✓Custom AI agents

For viral brands

Need more mentions or keywords?

You can add extra mentions (from $0.01 per mention) and keywords (from $5/month) to any plan – with full cost control and flexibility.

Loved by founders, marketers, and dev-facing teams

Anna Redbond

Head of Marketing, Flagsmith

There's few tools I'd put my name to, Octolens is one of them - it's worth trying

Igor Lamos

Founder, beplus.cloud

Subscribed and already getting relevant posts. Onboarding is simple, I was able to get up & running in few minutes.

Mike Choi

Founder, South Park Commons

Great product! Super useful if you want to know what your customers/competitors are talking about your product. You could do this manually but the amount of time/brain cycles you save from this product is definitely worth it 👍

Guillermo Rauch

CEO, Vercel

Wild AI-native onboarding experience. I literally entered zero input other than `vercel⁠.com` 🫨

Robin Guldener

Co-Founder, Nango (YC W23)

Octolens is very helpful for us to find relevant conversations in social media for our open-source product. Would not want to miss this in my toolchain anymore!

Leonard Püttmann

Developer Relations, Kern AI

At Kern AI, we use Octolens daily. It's a fantastic tool to engage with your community and find content quickly.

Matija Sosic

Co-Founder, Wasp (YC W21)

This is a really helpful tool for every community builder!

Alex Harris

Founder, Adadot

Here at Adadot we have a daily power-hour during which we use Octolens to surface any community content with commenting on or sharing. Great tool!

Anna Redbond

Head of Marketing, Flagsmith

There's few tools I'd put my name to, Octolens is one of them - it's worth trying

Igor Lamos

Founder, beplus.cloud

Subscribed and already getting relevant posts. Onboarding is simple, I was able to get up & running in few minutes.

Mike Choi

Founder, South Park Commons

Guillermo Rauch

CEO, Vercel

Wild AI-native onboarding experience. I literally entered zero input other than `vercel⁠.com` 🫨

Robin Guldener

Co-Founder, Nango (YC W23)

Octolens is very helpful for us to find relevant conversations in social media for our open-source product. Would not want to miss this in my toolchain anymore!

Leonard Püttmann

Developer Relations, Kern AI

At Kern AI, we use Octolens daily. It's a fantastic tool to engage with your community and find content quickly.

Matija Sosic

Co-Founder, Wasp (YC W21)

This is a really helpful tool for every community builder!

Alex Harris

Founder, Adadot

Here at Adadot we have a daily power-hour during which we use Octolens to surface any community content with commenting on or sharing. Great tool!

Hakim Elakhrass

Co-founder, NannyML

All of our content writers also use Octolens to find relevant mentions to comment on.

Felix Magedanz

Founder, Hanko

A happy customer since day 1. Octolens helps us keep up with the chatter on all relevant platforms.

David Paffenholz

CEO & Co-Founder, Juicebox (YC S22)

Octolens is part of my daily routine. I save hours a week checking socials for important conversations about PeopleGPT.

Mahmoud Mabrouk

Co-founder, Agenta

I've been using Octolens for a couple of months, and it is really helpful. The AI feature to filter the mentions to the ones relevant to you is very useful and spares me lots of times looking into hundreds of irrelevant posts.

George Novik

Founder, Zerocoder

Octolens is a game changer for DevTool companies! It's great to see a tool that prioritizes genuine engagement over traditional marketing tactics.

Johannes Hötter

Co-Founder, Kern AI

Octolens allows us to find relevant discussions outside of our own spectrum. It's literally scanning all relevant platforms, and then suggesting where we need to engage with developers to have a high chance to attract new engaged users.

Hakim Elakhrass

Co-founder, NannyML

All of our content writers also use Octolens to find relevant mentions to comment on.

Felix Magedanz

Founder, Hanko

A happy customer since day 1. Octolens helps us keep up with the chatter on all relevant platforms.

David Paffenholz

CEO & Co-Founder, Juicebox (YC S22)

Octolens is part of my daily routine. I save hours a week checking socials for important conversations about PeopleGPT.

Mahmoud Mabrouk

Co-founder, Agenta

George Novik

Founder, Zerocoder

Octolens is a game changer for DevTool companies! It's great to see a tool that prioritizes genuine engagement over traditional marketing tactics.

Johannes Hötter

Co-Founder, Kern AI

FAQ

Frequently asked questions

Everything you need to know about the Octolens MCP server

MCP is an open standard for connecting AI assistants to external tools and data sources. It lets Claude, ChatGPT, Cursor, and other AI tools access your Octolens data directly — you ask questions in natural language, and your assistant calls the Octolens MCP server on your behalf. Learn more at modelcontextprotocol.io

Claude Code, Claude Desktop, Claude Web, ChatGPT (via Developer Mode apps), and Cursor — plus any other client that supports remote MCP servers with OAuth. The server URL is https://app.octolens.com/api/mcp/v2.

No. Octolens MCP v2 uses OAuth: you add the server URL to your AI tool, and on first use it opens a browser tab where you sign in to your Octolens account. There is no key to create, paste into config files, or rotate.

Yes, if you ask it to. 9 of the 23 tools are write operations: adding, updating, pausing, or deleting keywords, accepting or rejecting keyword suggestions, and creating or managing feeds and their Slack, email, or webhook destinations. Reads (mentions, analytics, usage, workspace info) make up the other 14 tools. Your assistant only acts within the workspace you signed into.

MCP is a conversational interface for interactive AI workflows — you or your agent ask in natural language. The REST API is for programmatic access: scripts, backend jobs, and standalone HTTP clients. Both expose the same data. If you're building automation, use the API; if you're working inside an AI tool, use MCP.

The social listening data in the workspace you sign into: mentions with sentiment and relevance scores, SQL analytics over that data, your keywords and feeds, tags, usage against plan limits, and the workspace's company profile and global filters. It does not have access to billing details or other workspaces.

All of them. MCP, API, and webhooks are available on every Octolens plan, including the free trial. MCP queries read the mentions your plan has already collected, so there's no separate MCP pricing.

Remove the Octolens server from your AI tool's MCP settings (or delete the connector), and the tool can no longer reach your data. Because access is tied to your Octolens sign-in rather than a long-lived API key, there's no key to hunt down and revoke.

Available on all plans

Put your mentions one prompt away

Connect Octolens to Claude, Cursor, or ChatGPT in under a minute — OAuth sign-in, no API key.

Start 7-day free trial Book a demo

No credit card required · API access on all plans · Cancel anytime