Meltwater MCP server

Overview

This tool pack gives an agent access to Meltwater media monitoring, covering saved searches (monitors), mention retrieval with keyword and sentiment filters, and both pre-defined and custom analytics reports. Start by listing monitors to get a search id, then fetch mentions or analytics for a date window.

For setup instructions, see SnapLogic MCP Server quickstart.

Example Prompts

Break down last month's coverage by source
Show me weekly mention volume since January
Give me the top 20 keyphrases in our coverage this quarter
How many unique authors wrote about us in May?
What's the average reach per mention over the last 30 days?
Show daily coverage volume for negative mentions only
How many mentions did our brand monitor get this week?
What's the sentiment breakdown for coverage in May?
Show me the top sources covering us over the last month
What keyphrases are trending in our coverage right now?

Tools


Tool Name	Functions
MeltwaterCustomAnalytics	Run a configurable Meltwater analytics query — counts, top terms, time series, unique counts or measure statistics — over a saved search.
MeltwaterGetAnalytics	Fetch a pre-defined Meltwater analytics report (volume, sentiment, top sources, top keyphrases, and more) for a saved search.
MeltwaterListSearches	List Meltwater saved searches (monitors) and their IDs.
MeltwaterListTags	List all tags defined in the Meltwater account.
MeltwaterSearchMentions	Search a Meltwater monitor's mentions over a date range with keyword, source, language, country and sentiment filters.

Set up the MCP Server tools

Download meltwater_tools.zip.
In SnapLogic Designer, open the target project space (or create one), then choose Import Project / Import Pipelines and select the downloaded meltwater_tools.zip. Designer unpacks each pipeline into the project.
Attach the required account to the connectivity snaps (see Connection Setup).
Expose the project as an MCP server — each pipeline becomes a tool named after its label. New to this? Start with the MCP quickstart, then use the MCP Server Pipeline Builder to generate the server from the imported pipelines.

Configure account

Attach an API Suite account (OAuth 2.0 or Bearer token) to the HTTP Client snap in Designer after import.

These pipelines ship without credentials by design — attach a valid account in Designer before the tools will execute.

See the SnapLogic account documentation for this connector: API Suite Account Configuration.

Important: These pipelines ship without credentials by design — attach a valid account in Designer before the tools will execute. Credentials live in the SnapLogic account store, never in the pipeline JSON.

MeltwaterCustomAnalytics

Runs a configurable analytics query against a Meltwater saved search when pre-defined reports do not cover the question, supporting counts, time series, top terms, unique counts, and measure statistics. Use MeltwaterGetAnalytics instead when a standard report such as volume, sentiment, or top sources is sufficient.


Parameter	Type	Default	Description
search_id*	string	—	ID of the saved search to analyse. Resolve it with MeltwaterListSearches.
start*	string	—	Start of the analysis window, ISO 8601. A bare date is padded to midnight.
end*	string	—	End of the analysis window, ISO 8601. A bare date is padded to 23:59:59.
tz	string	`UTC`	IANA timezone the window is interpreted in (default UTC).
analysis_type*	string	`document_count`	document_count, top_terms, date_histogram, count_unique or measure_statistics (default document_count).
dimension	string	—	Field to break down by for top_terms and count_unique, e.g. source_name, sentiment, language, location_country, author_name, media_type, keyphrase, entity_name, hashtag.
measure	string	—	Metric for measure_statistics, e.g. engagement, reach, views, social_echo.
granularity	string	—	Bucket size for date_histogram: hour, day, week or month.
limit	integer	`10`	Number of terms returned by top_terms, 1-100 (default 10).
keywords	string	—	Comma-separated keywords narrowing the mentions analysed.
sentiments	string	—	Comma-separated sentiment filter: positive, negative, neutral.
sources	string	—	Comma-separated source filter.

* Required parameter.

Try asking:

Break down last month's coverage by source
Show me weekly mention volume since January
Give me the top 20 keyphrases in our coverage this quarter
How many unique authors wrote about us in May?
What's the average reach per mention over the last 30 days?
Show daily coverage volume for negative mentions only

MeltwaterGetAnalytics

Fetches a pre-defined Meltwater analytics report (such as volume, sentiment, top sources, or top keyphrases) for a saved search over a date window. Use MeltwaterCustomAnalytics when you need a breakdown Meltwater does not provide as a standard report.


Parameter	Type	Default	Description
search_id*	string	—	ID of the saved search to report on. Resolve it with MeltwaterListSearches.
type*	string	`volume`	Report to run: volume, sentiment, top_keyphrases, top_sources, top_countries, top_languages, top_shared_links, top_entities, top_locations, top_tags, top_mentions, top_shared, daily_volume, hourly_volume (default volume).
start*	string	—	Start of the reporting window, ISO 8601. A bare date is padded to midnight.
end*	string	—	End of the reporting window, ISO 8601. A bare date is padded to 23:59:59.
tz	string	`UTC`	IANA timezone the window is interpreted in (default UTC).

* Required parameter.

Try asking:

How many mentions did our brand monitor get this week?
What's the sentiment breakdown for coverage in May?
Show me the top sources covering us over the last month
What keyphrases are trending in our coverage right now?
Give me daily volume for the launch monitor since 1 June
Which countries drove the most coverage last quarter?

MeltwaterListSearches

Lists the saved searches (monitors) configured in the Meltwater account, returning each one's id, name, and type. Start here to resolve a monitor name into the search id that all mentions and analytics tools require.


Parameter	Type	Default	Description
page	integer	`1`	Page number, 1-indexed (default 1).
page_size	integer	`50`	Saved searches returned per page, max 100 (default 50).

Try asking:

What Meltwater monitors do we have set up?
List our saved searches and their IDs
Find the Meltwater search for our product launch
Show me the first 100 monitors in the account
Which of our monitors was updated most recently?

MeltwaterListTags

Lists every tag defined in the Meltwater account, returning each tag's id and name. Use it to see what categories exist or to translate a tag name into an id before filtering tagged coverage.

No parameters.

Try asking:

What tags do we have in Meltwater?
List all our media tags
What categories are set up for mentions?
Is there a tag for crisis coverage?

MeltwaterSearchMentions

Retrieves media and social mentions captured by a Meltwater saved search over a date window, with optional filters for keyword, source, language, country, and sentiment. Use it when you want to read actual coverage rather than an analytics roll-up.


Parameter	Type	Default	Description
search_id*	string	—	ID of the saved search/monitor to query. Resolve it with MeltwaterListSearches.
start*	string	—	Start of the date window, ISO 8601 (e.g. 2026-04-01T00:00:00Z). A bare date is padded to midnight.
end*	string	—	End of the date window, ISO 8601. A bare date is padded to 23:59:59.
tz	string	`UTC`	IANA timezone the date window is interpreted in (default UTC).
keywords	string	—	Comma-separated keywords to narrow the mentions.
sources	string	—	Comma-separated source filter.
languages	string	—	Comma-separated language codes.
countries	string	—	Comma-separated country codes.
sentiments	string	—	Comma-separated sentiment filter: positive, negative, neutral.
sort_by	string	`date`	Sort field: date, reach, engagement, sentiment or relevance (default date).
sort_order	string	`desc`	asc or desc (default desc).
page	integer	`1`	Page number, 1-10 (default 1).
page_size	integer	`25`	Mentions per page, 10-100 (default 25).

* Required parameter.

Try asking:

What coverage did we get between 1 and 20 April?
Show me this month's mentions from our brand monitor, most recent first
Find negative mentions of us in the UK and Germany last week
What did French-language outlets write about the launch?
Give me the 50 highest-reach mentions from the last 30 days
Show mentions matching 'pricing' or 'outage' from techcrunch.com this quarter