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

NameTypeRequiredDescription
querystringnoKeywords 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.
countrystringno2-letter country code to filter news by, e.g. “us”, “gb”, “in”
categorystringnoNews 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”).
languagestringnoLanguage code to filter news by, e.g. “en”, “es”, “fr”
from_datestringnoStart 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_datestringnoEnd of a PAST date window, YYYY-MM-DD. See from_date.
pagestringnonextPage token returned from a prior call, to fetch the next page of results
_apiKeystringnoOptional — 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.

Regenerated from source · build October 17, 2026