List mentions
Lists the mentions of a project as the Mentions tab shows them.
MCP tool brand24_read → list_mentions
read
Returns each mention with its ID, title, link, source, publication time, sentiment, tags and the followers or monthly visits Brand24 shows. Reading does not open the Visit link. When more mentions match, next_cursor is set. The IDs are what the write tools take.
Parameters
| Name | Type | Description |
|---|---|---|
| project_id integer required | integer | Project ID from list_projects. |
| date_from string | string | Start of the date range, YYYY-MM-DD. |
| date_to string | string | End of the date range, YYYY-MM-DD. |
| query string | string | Words the mention must include, like the Mentions tab search bar. Boolean search works. |
| sentiment string | string | Only mentions with this sentiment: positive, neutral or negative. |
| tag string | string | Only mentions with this tag, by name from list_tags. |
| sort string | string | recent for Recent Mentions First (default) or popular for Popular Mentions First. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "brand24_read",
"arguments": {
"operation": "list_mentions",
"arguments": {
"project_id": 1
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"mentions": [
{
"mention_id": "7001234501",
"title": "Best espresso grinder for small cafes?",
"url": "https://forum.example/t/espresso-grinders",
"source": "forum.example",
"published_at": "2026-10-18T09:14:00Z",
"sentiment": "positive",
"tags": [],
"followers_or_visits": 12400
},
{
"mention_id": "7001234502",
"title": "Grinder arrived with a cracked hopper",
"url": "https://social.example/p/88123",
"source": "@maya_brews",
"published_at": "2026-10-18T07:52:00Z",
"sentiment": "negative",
"tags": [
"Complaint"
],
"followers_or_visits": 3100
},
{
"mention_id": "7001234503",
"title": "Coupon: 40% off coffee gear this week",
"url": "https://coupon-deals.example/northwind",
"source": "coupon-deals.example",
"published_at": "2026-10-17T22:30:00Z",
"sentiment": "neutral",
"tags": [],
"followers_or_visits": 870
}
],
"next_cursor": null
},
"isError": false
}