Mentio MCP server
Commit Nov 10, 2026Monitor social media mentions across platforms like Reddit, X, and GitHub to track relevance, sentiment, and intent using a command-line interface.
Also known as mentio-dev/cli
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 10, 2026
- License
- MIT
What is Mentio MCP?
Mentio monitors social media mentions across platforms like Reddit, X, and GitHub to track relevance, sentiment, and intent using a command-line interface.
Summary generated from the project's README
About Mentio MCP server
Tracking social media mentions across platforms like Reddit, X, GitHub, and LinkedIn is what Mentio CLI enables for developers and brand monitors. It monitors various sources including Hacker News, Bluesky, Stack Overflow, and YouTube to score mentions based on relevance, sentiment, and intent. Users can manage these insights through a command-line interface that uses noun:verb command structures to interact with the Mentio API.
Setting up the tool requires Node 22+ and a Mentio API key, which can be provided via environment variables, command flags, or by using the auth:login command to sign in through a browser. The server supports local use via the CLI or remote integration with MCP clients like Claude, Cursor, or VS Code. It provides specialized commands for managing keywords, mentions, people, segments, and analytics, while offering a live mentions feed that pipes JSON output directly into other tools like jq.
What you can do with it
- 1Monitor specific brand keywordsCreate new keyword tracking rules for specific terms across selected social platforms.
- 2Filter mentions by intentSearch for social media posts that specifically demonstrate a desire to purchase a product.
- 3Stream live social feedsWatch a real-time stream of new mentions on Reddit that match specific intent criteria.
- 4Analyze brand performanceGenerate a summary of analytics over a specific time range to compare data trends.
Written from the project's README. Every use case is checked against a quote from it.
Configuration
MENTIO_API_KEY
| Name | Description | |
|---|---|---|
| MENTIO_API_KEY | — |
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablementio-dev/cli is public and reachablegithub.com/mentio-dev/cli ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/mentio-dev/cli ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubMentio CLI
mentio is the Mentio API on the command line: every endpoint as a noun:verb command, generated from the OpenAPI document, plus a live mentions feed and MCP helpers. Mentio watches Reddit, Hacker News, X, GitHub, Bluesky, LinkedIn, Stack Overflow, DEV, YouTube and news for your keywords and scores every mention for relevance, sentiment and intent. Node 22+.
Installation
npm install -g @mentio-dev/cli
# or run it without installing
npx @mentio-dev/cli --help
Quick start
mentio auth:login # signs in through the browser and stores a key
mentio keywords:create --term "acme cloud" --kind brand --platforms reddit,x
mentio mentions:search --relevant true --intent buy_intent --limit 20
mentio mentions:update mm_7f3a... --status done --note "replied 2026-09-14"
mentio analytics:summary --range 7d --compare true
mentio mentions:watch --platforms reddit | jq -r '.post.url'
Output is JSON: compact when piped, indented on a terminal, --table for lists.
Authentication
Three ways, in order of precedence:
mentio keywords:list --api-key mk_live_... # one command
export MENTIO_API_KEY=mk_live_... # the shell
mentio auth:set --key mk_live_... # stored for this machine; auth:login does this for you
mentio auth:login opens the dashboard, which mints a key named after your machine and hands it back to the CLI on a loopback port. --api-url or MENTIO_API_URL point the CLI at another deployment.
Commands
Generated commands take every query parameter and body field as a flag. --json '{...}' sends a whole body (- reads stdin) and flags override its fields. Exports take --out file.csv.
| Group | Commands |
|---|---|
keywords |
create, list, get, update, delete |
mentions |
search, get, update, export, watch |
people |
list, get, update, merge, split, export |
segments |
list, create, get, update, delete |
alerts |
list, create, get, update, delete, test, run |
channels |
list, create, get, update, delete, test, rotate-secret, deliveries |
analytics |
summary, series, breakdown, share-of-voice |
company |
get, update |
api-keys |
create, list, revoke |
system |
health |
auth |
login, set, and friends |
mcp |
config |
mentio <group>:<verb> --help prints every flag with the description from the API reference. Every command, by area, is documented at docs.mentio.dev/cli.
A live feed
mentio mentions:watch --platforms reddit --intents question --interval 30
Polls the API and prints each new mention as one JSON line, so it pipes into jq, a file, or anything that reads stdin. --from-start prints the current newest page first.
MCP helpers
mentio mcp:config # the JSON block for Claude, Cursor, VS Code or a generic MCP client
Or skip the CLI and add the server directly in Claude Code:
claude mcp add --transport http mentio https://mcp.mentio.dev/mcp
Errors
A non-2xx prints the API's error envelope on stderr, { "error": { "code", "message", "requestId" } }, and exits non-zero. The codes are stable and listed at docs.mentio.dev/errors.
Requirements
- Node 22+
- A Mentio API key (every account starts with $5.80 of credit, no card)
Links
- Documentation and the CLI guide
- API reference
- Dashboard
- TypeScript SDK, Python SDK, Claude Code skills
This repository is published from the Mentio monorepo on every release.
License
MIT.
Mentio MCP questions
What platforms does Mentio monitor?
Mentio tracks mentions on Reddit, Hacker News, X, GitHub, Bluesky, LinkedIn, Stack Overflow, DEV, YouTube, and news sources.
Can I use Mentio with Claude or other MCP clients?
Yes, you can generate a JSON configuration block using 'mentio mcp:config' or add the server directly in Claude Code via HTTP.
What are the system requirements for the Mentio CLI?
The CLI requires Node.js version 22 or higher.