Mention MCP by usefulapi
Read alerts, mentions, authors, statistics and shares in Mention.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mention": {
"url": "https://mention.usefulapi.io/mcp"
}
}
}Remote endpoints
https://mention.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢mention_get_my_account
Get the Mention account the access token belongs to (name, email, language). Mention API: GET /accounts/me.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mention_list_alerts(limit, cursor)
List the monitoring alerts (saved searches) of the account, with their keywords, sources and languages. Mention API: GET /accounts/{account_id}/alerts.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Number of alerts to return. Default: all.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"cursor": {
"description": "Pagination cursor from the previous _links.more href.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mention_get_alert(alert_id)
Get one alert by id: its keywords, excluded keywords, languages, countries and sources. Mention API: GET /accounts/{account_id}/alerts/{alert_id}.
Input Schema
{
"type": "object",
"properties": {
"alert_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "The alert id (from mention_list_alerts)."
}
},
"required": [
"alert_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mention_list_mentions(alert_id, since_id, before_date, not_before_date, source, ...)
List the mentions (posts and articles) found by one alert, newest first. Filter by date, source or unread state. Mention API: GET /accounts/{account_id}/alerts/{alert_id}/mentions.
Input Schema
{
"type": "object",
"properties": {
"alert_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "The alert id (from mention_list_alerts)."
},
"since_id": {
"description": "Return only mentions found after this mention id.",
"type": "string"
},
"before_date": {
"description": "Return mentions published before this ISO 8601 date-time.",
"type": "string"
},
"not_before_date": {
"description": "Ignore mentions published before this ISO 8601 date-time.",
"type": "string"
},
"source": {
"description": "One source name, for example web or twitter.",
"type": "string"
},
"unread": {
"description": "Only unread mentions.",
"type": "boolean"
},
"favorite": {
"description": "Only favorite mentions.",
"type": "boolean"
},
"limit": {
"description": "Number of mentions (default 20, max 1000).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
},
"cursor": {
"description": "Pagination cursor from the previous _links.more href.",
"type": "string"
}
},
"required": [
"alert_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mention_get_mention(alert_id, mention_id)
Get one mention by id with its full details (title, description, source, author, tasks). Mention API: GET /accounts/{account_id}/alerts/{alert_id}/mentions/{mention_id}.
Input Schema
{
"type": "object",
"properties": {
"alert_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "The alert id that found the mention."
},
"mention_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "The mention id (from mention_list_mentions)."
}
},
"required": [
"alert_id",
"mention_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mention_get_mention_task(alert_id, mention_id, task_id)
Get one task on a mention, including the teammate it is assigned to. Mention API: GET /accounts/{account_id}/alerts/{alert_id}/mentions/{mention_id}/tasks/{task_id}.
Input Schema
{
"type": "object",
"properties": {
"alert_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "The alert id that found the mention."
},
"mention_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "The mention id."
},
"task_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "The task id."
}
},
"required": [
"alert_id",
"mention_id",
"task_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mention_list_authors(alert_id, kind, from, to, sort, ...)
List the most active authors (influencers) found by one alert, with their scores. Mention API: GET /accounts/{account_id}/alerts/{alert_id}/authors.
Input Schema
{
"type": "object",
"properties": {
"alert_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "The alert id (from mention_list_alerts)."
},
"kind": {
"description": "Source kind, for example twitter or web.",
"type": "string"
},
"from": {
"description": "Only authors of mentions after this ISO 8601 date-time.",
"type": "string"
},
"to": {
"description": "Only authors of mentions before this ISO 8601 date-time.",
"type": "string"
},
"sort": {
"description": "Sort field, for example score.",
"type": "string"
},
"order": {
"description": "Sort order.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"limit": {
"description": "Number of authors to return.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
}
},
"required": [
"alert_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mention_get_stats(alert_ids, from, to, timezone, interval, ...)
Get mention statistics for one or more alerts over a date range, per day, week or month. Mention API: GET /accounts/{account_id}/stats.
Input Schema
{
"type": "object",
"properties": {
"alert_ids": {
"minItems": 1,
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
},
"description": "One or more alert ids (from mention_list_alerts)."
},
"from": {
"description": "Start of the range, ISO 8601 date-time.",
"type": "string"
},
"to": {
"description": "End of the range, ISO 8601 date-time.",
"type": "string"
},
"timezone": {
"description": "Timezone of from and to, for example Europe/Paris.",
"type": "string"
},
"interval": {
"description": "Period: P1D (day), P1W (week) or P1M (month).",
"type": "string",
"enum": [
"P1D",
"P1W",
"P1M"
]
},
"favorite": {
"description": "Only mentions in the favorite folder.",
"type": "boolean"
},
"important": {
"description": "Only mentions in the important folder.",
"type": "boolean"
}
},
"required": [
"alert_ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mention_list_tags(alert_id)
List the tags of one alert, with the number of mentions tagged. Mention API: GET /accounts/{account_id}/alerts/{alert_id}/tags.
Input Schema
{
"type": "object",
"properties": {
"alert_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "The alert id (from mention_list_alerts)."
}
},
"required": [
"alert_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mention_get_alert_preferences(alert_id)
Get the notification preferences of one alert (email, push and desktop frequency, weight). Mention API: GET /accounts/{account_id}/alerts/{alert_id}/preferences.
Input Schema
{
"type": "object",
"properties": {
"alert_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "The alert id (from mention_list_alerts)."
}
},
"required": [
"alert_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mention_list_shares(alert_id)
List the people and teams an alert is shared with, and their permissions. Mention API: GET /accounts/{account_id}/alerts/{alert_id}/shares.
Input Schema
{
"type": "object",
"properties": {
"alert_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
],
"description": "The alert id (from mention_list_alerts)."
}
},
"required": [
"alert_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence