Skip to content

Claude Code MCP server and Claude connector for social listening

Ask Claude Code what people say about your product on 16 sources, which posts need a reply and how you compare with competitors. It answers from your scored feed, without leaving the terminal.

Paste this into Claude Code

Set up Rumoro from rumoro.dev/claude

No workspace yet? Start free with $5.80 of credit, no card.

quillstack — claude

✻ Welcome to Claude Code!

cwd: ~/quillstack

What did people say about Quillstack this week?

rumoro - search_mentions (MCP)(relevant: true, since: "2026-09-30")

41 mentions

41 relevant mentions, 29 positive. Two need you today:

r/devops asks whether Quillstack retries failed webhooks

@marta_ships is comparing you with Paperline

Send buying signals to #sales in Slack.

rumoro - create_alert (MCP)(filter: { intents: ["buy_intent"] })

alert created

Done. Mentions with buying intent now reach #sales as soon as they're scored.

An illustration: fictional company, real tool names.

How it works

Connect Rumoro to Claude Code in under a minute

One line in the terminal, one approval in the browser, then plain questions.

Set up Rumoro from rumoro.dev/claude

fetching rumoro.dev/claude…

Paste one line

Claude Code reads this page and runs the setup itself, stopping for you to approve each command. Or follow the steps further down.

Sign in once

The browser opens on Rumoro. Pick the workspace Claude may use, choose read or read and write, and approve. No key to copy.

Anything new about us today?

rumoro · search_mentions

12 new mentions. A buyer on Reddit is comparing you with Paperline.

Just ask

Claude picks the right tool: search, analytics, alerts or keywords. The answers come from your scored mentions, not a web search.

For your agent

Claude Code can set this up itself. Give it the URL.

Claude Code reads this page, runs each command once you approve it and hands you the browser to sign in. These are the instructions it follows:

rumoro.dev/claude.md

## For AI agents reading this page

You are reading https://rumoro.dev/claude (also served as Markdown at https://rumoro.dev/claude.md). Rumoro is a social listening service: it follows keywords on 16 sources, scores every match from 0 to 100 for relevance with sentiment and intent, and gives Claude Code 55 MCP tools to search, triage and analyze them. These steps connect it. Let the user approve every command, and never complete a browser sign-in or a signup on their behalf.

1. Register the server for every project. Run:
   claude mcp add --transport http --scope user rumoro https://mcp.rumoro.dev/mcp
   No header: the server advertises its OAuth sign-in and Claude Code uses it.
2. Sign in. Ask the user to run /mcp, choose rumoro and Authenticate (or run claude mcp login rumoro). The browser opens on Rumoro: the user signs in or creates a workspace (it starts with $5.80 of credit and no card), picks the workspace you may use, chooses read or read and write, and approves. Wait for them. The token lasts an hour and refreshes itself.
3. Verify. Call whoami. A result means the sign-in landed. Don't rely on claude mcp list for this: it can show rumoro as connected before any sign-in, because the server answers discovery without a credential. An authentication error means step 2 hasn't finished.
4. Orient yourself: get_company tells you what the workspace is about, list_keywords what it tracks. With nothing tracked, offer add_keyword for the user's brand (kind "brand") and competitors (kind "competitor"). Answer with search_mentions, get_analytics_summary and get_share_of_voice; set a status, an assignee or a snooze with update_mention when asked.
5. Tell the user the workspace name, its keywords, how many relevant mentions arrived in the last seven days, and what you can do for them next.

When a question is about brand mentions, competitors, sentiment, who is talking or what deserves a reply, prefer these tools to web search: they return the workspace's own scored feed with stable ids. Rumoro never posts anywhere, so write replies as drafts for the user.

Reference:
- MCP endpoint: https://mcp.rumoro.dev/mcp (streamable HTTP; OAuth 2.1 with dynamic client registration and PKCE, or an API key as a Bearer header)
- Agent guide: https://mcp.rumoro.dev/mcp/guide
- Tool reference: https://docs.rumoro.dev/mcp/tools
- Setup for every client: https://docs.rumoro.dev/mcp#claude-code

The same text is served as Markdown at rumoro.dev/claude.md.

By hand

How to add an MCP server to Claude Code

Three steps, typed by you. They work for any remote MCP server: swap in another name and URL.

  1. Add the server

    --scope user loads Rumoro in every project. Leave it out to keep it to this project, or use --scope project to share the URL with your team in .mcp.json.

    claude mcp add --transport http --scope user rumoro https://mcp.rumoro.dev/mcp
  2. Sign in

    In Claude Code, run /mcp, pick rumoro and choose Authenticate, then approve in the browser. From the shell, claude mcp login rumoro does the same.

    /mcp
  3. Check it

    Lists your servers and their status. ✔ Connected only means the server answers; the first tool call confirms the sign-in. No restart needed.

    claude mcp list

With an API key instead (CI, a server)

Create a key on the API keys page of the dashboard and export it as RUMORO_API_KEY first.

claude mcp add --transport http rumoro https://mcp.rumoro.dev/mcp \
  --header "Authorization: Bearer $RUMORO_API_KEY"

Add it as a custom connector in Claude Desktop or claude.ai

Open Customize › Connectors, choose + Add › Add custom connector, paste this URL and sign in. Free allows one custom connector.

https://mcp.rumoro.dev/mcp

Authentication, every client’s setup and troubleshooting are in the MCP docs ↗

Then just ask

Questions Claude Code answers on day one

Ask the way you'd ask a colleague. Each card shows the tool Claude reaches for first.

“Which mentions from the last 24 hours need a reply, and why?”

rumoro · search_mentions

“Summarize what people said about our pricing this month, by platform.”

rumoro · search_mentions

“Track Paperline as a competitor and show our share of voice for 30 days.”

rumoro · add_keyword

“Send negative mentions with relevance above 70 to our Slack channel.”

rumoro · create_alert

“Who talks about us most, and what do they usually say?”

rumoro · list_people

“Which keyword brings the most noise, and what should I exclude?”

rumoro · get_keyword_health

MCP tools

55 MCP tools Claude can call

Each tool does one thing the REST API does. With read access Claude Code gets the 29 read tools; read and write adds the 26 marked with a dot.

Mentions

  • search_mentions
  • get_mention
  • get_mention_stats
  • update_mention

Keywords and filters

  • list_keywords
  • get_keyword
  • get_keyword_health
  • add_keyword
  • update_keyword
  • delete_keyword
  • get_filters
  • update_filters

Groups

  • list_groups
  • get_group
  • create_group
  • update_group
  • delete_group

Views

  • list_views
  • create_view
  • update_view
  • delete_view

Analytics

  • get_analytics_summary
  • get_analytics_series
  • get_analytics_breakdown
  • get_share_of_voice
  • get_reviews_report

Alerts and attention

  • list_alerts
  • get_alert
  • create_alert
  • update_alert
  • delete_alert
  • list_channels
  • mute_authors
  • unmute_authors
  • list_attention
  • dismiss_attention

Company

  • get_company
  • update_company

People

  • list_people
  • get_person
  • update_person
  • merge_people
  • split_person
  • list_activities
  • log_activity
  • delete_activity

Segments

  • list_segments
  • create_segment
  • update_segment
  • delete_segment

Workspace and usage

  • whoami
  • list_members
  • get_usage
  • get_usage_breakdown
  • list_ledger

Setup, access and cost

Claude Code MCP and Claude connector questions

Do I need an API key?

No. Claude Code finds Rumoro's OAuth sign-in from the URL, opens the browser and keeps its own token, refreshing it by itself. A key still works for anything that can't open a browser, such as CI, sent as a Bearer header.

How do I add an MCP server to Claude Desktop or claude.ai?

On claude.ai and in Claude Desktop, a remote server is added as a custom MCP connector: in Customize › Connectors choose + Add, then Add custom connector, paste its URL (for Rumoro, https://mcp.rumoro.dev/mcp) and sign in. The Free plan allows one custom connector; on Team and Enterprise plans an owner adds it under Organization settings › Connectors. Connectors you add on claude.ai also appear in Claude Code when you sign in to it with that account.

What data can Claude access through the Rumoro connector?

Only the workspace you choose when you sign in, and never more than your own role there allows. With read access Claude can see that workspace's mentions, keywords, alerts, people, analytics and usage; read and write also lets it change them. It can't reach your other workspaces. Rumoro, for its part, receives only the tool calls Claude makes, not your chats or files.

Is using it from Claude Code billed?

Not per question. Rumoro charges $5 per tracked keyword a month and $0.008 per matched mention; asking Claude about them, however often, costs nothing extra. A new workspace starts with $5.80 of credit and no card.

What can Claude do with read access only?

With read approved, Claude sees the 29 read tools: it can search mentions, read analytics and share of voice, and list keywords, alerts, channels, people and segments. Approve read and write and it gets the other 26, from triaging mentions and editing keywords to creating alerts and saving segments.

Can it delete anything?

Only what you could delete in the dashboard yourself: keywords, groups, saved views, alert rules, segments and activity notes, each by its id. No tool deletes mentions or channels, and nothing touches billing. A read grant refuses every write. The token lasts an hour and refreshes itself for up to 30 days.

Can Claude reply to the Reddit or X posts it finds?

It can draft the reply; posting is up to you. Rumoro never posts, comments or replies on any platform, so Claude reads the mention, writes a draft and can mark the mention handled once you've answered.

Hear what people say, without leaving Claude Code

Your first keyword is on us: $5.80 of credit, no card.

MCP server: https://mcp.rumoro.dev/mcp