Meltwater MCP Server

Add tags to up to 100 documents asynchronously. Provide document_ids and tags_json (array of {id} and/or {name} objects).

Run a custom earned-media analytics query (document_count, top_terms, date_histogram, measure_statistics, nested combinations). Provide the full POST ...

Create a REST hook that POSTs new search matches to target_url. Returns hook_id for later deletion. Save X-Hook-Secret from the response to verify pay...

Start a one-time mention export for saved searches and a UTC date window. Returns export id and PENDING status — poll by passing export_id when fetchi...

Create a recurring mention export schedule for saved searches. Poll individual schedules by passing export_id when fetching recurring exports.

Create a document tag on the Meltwater account. Tag names must be unique within the company.

Delete a REST streaming hook by id. Stops delivery of new matches to the hook target_url.

Delete a one-time mention export job by id.

Delete a recurring mention export schedule by id.

Delete a saved search by id. This permanently removes the search definition from the Meltwater account.

Delete a document tag by id. Documents that had this tag will have it removed.

Fetch the latest custom analytics catalog: available dimensions, measures, and analytic types for custom earned-media analytics requests.

Pre-defined analytics summary for a saved search: total mention volume, daily/hourly breakdown, sentiment mix, top countries, and top languages for th...

Ranked entities (people, organizations, etc.) detected in documents matching a saved search.

Ranked keyphrases extracted from documents matching a saved search for the requested window.

Ranked geographic locations in documents matching a saved search. Optional level (country, state, city). Defaults to top 100 locations.

Top individual mention documents matching a saved search, ranked for the requested window.

Most-shared documents matching a saved search in a time window. Optional sort_by controls ranking (e.g. retweets).

Ranked URLs shared in documents matching a saved search for the requested window.

Top authors/sources driving mentions for a saved search in a time window. Requires search_id, start, end, and tz; optional size (default 10).

Ranked tags (hashtags, etc.) appearing in documents matching a saved search for the requested window. Requires search_id, start, end, and tz.

Ranked topics detected in documents matching a saved search for the requested window.

API request usage statistics for the authenticated token. Use to check consumption against package limits before large analytics or export jobs.

List Meltwater companies accessible to the authenticated token. Use company id values as company_id on searches, analytics, and exports when the accou...

List saved filter sets available on the account (custom and optional quickpick presets). Filter sets can be attached to saved searches in the Meltwate...

List REST streaming hooks on the account. Hooks push new search matches to a target_url as documents arrive.

List one-time mention exports or fetch one export by id (status PENDING, FINISHED, CANCELLED, EXPIRED). When FINISHED, data_url points at the export f...

List connected owned social accounts (Facebook, Instagram, etc.) for the authenticated company. Use account ids with owned metrics tools.

Single-level owned-account metric breakdown (e.g. audience by country). Requires source, account_ids, metrics, start, and end.

Owned-account activity heatmap by day and hour. Requires source, account_ids, metrics, start, and end.

Two-level owned-account metric breakdown (e.g. gender then age). Requires source, account_ids, metrics, start, and end.

Simple numeric owned-account metrics (page fans, followers, etc.). Requires source, account_ids, metrics, start, and end.

List metric ids supported by Meltwater owned-account analytics. Use these ids in owned metrics breakdown, heatmap, numeric, and top-posts tools.

Top posts for owned social accounts ranked by engagement metrics. Supports pagination and sort options.

List recurring mention export schedules or fetch one recurring export by id, including previous run metadata when available.

Estimate how many mentions match a saved search in a time window. Provide search_id; optionally start_date and end_date (ISO8601). Faster than full an...

List saved earned-media searches on the Meltwater account, or fetch one search by id. Listing returns each search id, name, and last updated time. A s...

List document tags on the Meltwater account. Tags can be applied to mentions in the product UI and referenced when filtering exports.

List Meltwater workspaces on the authenticated account. Useful for understanding workspace scope before running searches or analytics.

Remove tags from up to 100 documents asynchronously. Provide document_ids and tags_json (array of {id} and/or {name} objects).

Create or update a saved earned-media search. Omit search_id to POST a new search; pass search_id to PUT an update. Provide the full search payload as...