---
title: "Social Listening MCP Server for Every AI Agent | Rumoro"
description: "Connect Claude Code, Cursor, Codex, Grok, Hermes or OpenClaw to Rumoro with one URL and one sign-in: 55 MCP tools over 16 sources, no key to paste."
canonical: https://rumoro.dev/agents
---

# Ask your AI agent what people are saying about you

Rumoro answers from mentions on 16 sources, already scored for relevance, sentiment and intent. Connect Claude Code, Cursor, Codex, Grok, Hermes or OpenClaw over MCP with one URL and one sign-in.

MCP server: https://mcp.rumoro.dev/mcp (streamable HTTP; OAuth 2.1 with dynamic client registration and PKCE, or an API key as a Bearer header)

## Setup guides for each agent

- [Rumoro for Claude Code](https://rumoro.dev/claude) (Markdown: https://rumoro.dev/claude.md), MCP. One command, then /mcp to sign in. Also a custom connector in claude.ai and Claude Desktop. `claude mcp add --transport http rumoro https://mcp.rumoro.dev/mcp`
- [Rumoro for Codex](https://rumoro.dev/codex) (Markdown: https://rumoro.dev/codex.md), MCP. Two commands: add the server, then log in. `codex mcp add rumoro --url https://mcp.rumoro.dev/mcp`
- [Rumoro for Cursor](https://rumoro.dev/cursor) (Markdown: https://rumoro.dev/cursor.md), MCP. One click or one entry in mcp.json, then sign in under Customize. `"rumoro": { "url": "https://mcp.rumoro.dev/mcp" }`
- [Rumoro for Grok](https://rumoro.dev/grok) (Markdown: https://rumoro.dev/grok.md), MCP connector. A custom connector on grok.com, then sign in. `grok.com/connectors › New Connector › Custom`
- [Rumoro for Hermes](https://rumoro.dev/hermes) (Markdown: https://rumoro.dev/hermes.md), MCP. One entry in config.yaml, then hermes mcp login. `hermes mcp login rumoro`
- [Rumoro for OpenClaw](https://rumoro.dev/openclaw) (Markdown: https://rumoro.dev/openclaw.md), MCP or ClawHub skill. Native MCP with one sign-in, or Rumoro's ClawHub skill with an API key. `openclaw mcp add rumoro --url https://mcp.rumoro.dev/mcp --transport streamable-http --auth oauth`

## 55 MCP tools

- 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

Read access exposes the 29 read tools; read and write adds the other 26. Tool reference: https://docs.rumoro.dev/mcp/tools

## Questions

### What is Rumoro's MCP server?

A hosted server at https://mcp.rumoro.dev/mcp that gives any MCP client 55 tools over your Rumoro workspace: search and triage mentions from 16 sources, read analytics and share of voice, and manage keywords, alerts, people and segments. Each tool does what one REST API operation does.

### Do I need an API key?

No. The server speaks OAuth 2.1 with dynamic client registration, so your agent registers itself from the URL, you sign in and approve once, and it refreshes its own token. A key still works where no browser can open, such as CI or a server, sent as a Bearer header.

### Which AI agents does it work with?

Any client that speaks MCP over streamable HTTP. Claude Code, Cursor, Codex, Grok, Hermes and OpenClaw have their own guides here, and claude.ai and Claude Desktop take it as a custom connector. The MCP docs show the settings for other clients. OpenClaw can also use Rumoro's ClawHub skill, which calls the REST API.

### Is it billed per call?

No. Rumoro charges $5 per tracked keyword a month and $0.008 per matched mention, from a prepaid balance; calls from your agent are free. A new workspace starts with $5.80 of credit and no card.

### Can a read-only connection change anything?

No. Approve read access when you sign in, or connect with a read key, and the agent sees only the 29 read tools; every write is refused.