latest_news
Pack: newsdata · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/latest_news for the schema, then POST the same URL with its arguments for the data.
Get news headlines and articles — world news, breaking news, and business/financial/stock-market news. Filter by keyword, country (2-letter, e.g. “us”), category (business, technology, politics, sports, health, science), and language. IMPORTANT: for stock-market / financial-market / economy / “world market news” questions, ALWAYS pass category: “business” — it returns real market-news outlets and filters out low-quality SEO/crypto-promo articles. Returns article title, description, link, source, publish date, category, and country. Paginate via the nextPage token. WITHOUT from_date/to_date this covers only roughly the LAST 48 HOURS (NewsData.io’s rolling “latest” feed) — asking about an older event with no date window silently returns today’s unrelated articles instead of an empty result. For a PAST date range, pass from_date/to_date (YYYY-MM-DD): this routes to NewsData.io’s archive endpoint, which requires a plan tier above the shared platform key’s default — if the account cannot serve it, the call returns a filter_gap field naming the unsupported window instead of silently substituting the latest 48h. Examples: latest_news({ query: “stock market”, category: “business” }) for current world market news; latest_news({ query: “election”, country: “us”, category: “politics” }); latest_news({ query: “Houthi Yemen attack”, from_date: “2026-08-01”, to_date: “2026-08-15” }) for an August event.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | no | Keywords to search news articles for. Every term is AND-ed — each word must appear in the article — so use 1-3 distinctive keywords (“NMPA approval biotech”, “AI chips”) rather than a full phrase; “Chinese biotech out-licensing deals NMPA approvals” returns 0 results while “NMPA Chinese biotech” returns articles. |
country | string | no | 2-letter country code to filter news by, e.g. “us”, “gb”, “in” |
category | string | no | News category, e.g. “business”, “technology”, “politics”, “sports”, “health”, “science”. OMIT unless confident — a wrong category guess returns 0 results (e.g. drug-approval and pharma-industry stories are categorized “business”, not “health”). |
language | string | no | Language code to filter news by, e.g. “en”, “es”, “fr” |
from_date | string | no | Start of a PAST date window, YYYY-MM-DD. Supplying this (or to_date) switches the call from the 48h “latest” feed to NewsData.io’s archive endpoint, which may require a higher plan tier than the shared platform key has — if so, the response carries filter_gap naming the unsupported window rather than silently returning current articles. |
to_date | string | no | End of a PAST date window, YYYY-MM-DD. See from_date. |
page | string | no | nextPage token returned from a prior call, to fetch the next page of results |
_apiKey | string | no | Optional — your own NewsData.io API key for higher limits; omit to use the shared Pipeworx key. |
Example call
Arguments
{
"query": "stock market",
"category": "business"
}
curl
curl -X POST https://gateway.pipeworx.io/newsdata/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"latest_news","arguments":{"query":"stock market","category":"business"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('latest_news', {
"query": "stock market",
"category": "business"
});
More examples
{
"query": "election",
"country": "us",
"category": "politics",
"language": "en"
}
Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the newsdata pack
{
"mcpServers": {
"newsdata": {
"url": "https://gateway.pipeworx.io/newsdata/mcp"
}
}
}
See Getting Started for client-specific install steps.