Press Monitor Wikidata NewsFlow MCP Server β Usage Guide
This guide shows how to call the MCP tools that mirror the News-Wikidata API endpoints. Ideal for AI agents and automations using JSON-RPC.
MCP Base URL
https://mcp.pressmonitor.com/news-wikidata/v1
Authentication
All MCP calls require:
Authorization: Bearer YOUR_API_KEY
MCP Configuration Example (mcp.json)
{ "mcpServers": { "news-wikidata": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.pressmonitor.com/news-wikidata/v1", "--header", "Authorization: Bearer ${NEWS_WIKIDATA_API_TOKEN}" ], "env": { "NEWS_WIKIDATA_API_TOKEN": "" } } } }
List Available Tools
curl -s -X POST "https://mcp.pressmonitor.com/news-wikidata/v1" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Invoke a Tool - Example
1) news_headlines
curl -s -X POST "https://mcp.pressmonitor.com/news-wikidata/v1" -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_SECRET_KEY:SUBSCRIPTION_ID" -d '{ "jsonrpc":"2.0", "id": 1, "method":"tools/call", "params":{ "name":"news_headlines", "arguments": { "wikidata_id": "Q90", "count": 10, "sort": "latest" } } }'
2) news_fulltext_metadata_translated
curl -s -X POST "https://mcp.pressmonitor.com/news-wikidata/v1" -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_SECRET_KEY:SUBSCRIPTION_ID" -d '{ "jsonrpc":"2.0", "id": 2, "method":"tools/call", "params":{ "name":"news_fulltext_metadata_translated", "arguments": { "wikidata_id": "Q90", "target_lang_code": "en", "count": 5 } } }'
Result Envelope (typical)
MCP responses embed tool output in a JSON-RPC envelope:
{ "jsonrpc": "2.0", "id": 1, "result": { "content": [{ "type": "json", "json": { "items": [ /* array of story objects */ ], "credits": { /* rate, quantity, total, request_id */ }, "next": { /* search_after, count, sort */ } } }] } }
Tool β Endpoint Mapping & Arguments
Each tool corresponds 1:1 with an API route and accepts the same arguments.
-
news_headlines β
GET /news-headlinesArgs:wikidata_id(required),country_code,lang_code,count,sort,search_after -
news_briefs β
GET /news-briefsArgs: same as above -
news_fulltext β
GET /news-fulltextArgs: same as above -
news_fulltext_metadata β
GET /news-fulltext-metadataArgs: same as above -
news_headlines_translated β
GET /news-headlines-translatedArgs:wikidata_id(required),target_lang_code(required), pluscountry_code,lang_code,count,sort,search_after -
news_briefs_translated β
GET /news-briefs-translatedArgs: as above (items include atrtranslation block) -
news_fulltext_translated β
GET /news-fulltext-translatedArgs: as above (items includetr) -
news_fulltext_metadata_translated β
GET /news-fulltext-metadata-translatedArgs: as above (items includetr)
Tips
- Use
sort=latestfor polling +next.search_afterto page forward efficiently. - For multilingual workflows, prefer the translated tools and store both original fields and the
tr.*translations. - Headlines/briefs are cost-effective for monitoring; fulltext/metadata are ideal for analytics and model finetuning.
Support
Docs: https://www.pressmonitor.com/en/docs/news-wikidata-api-mcp
Email: support@pressmonitor.com