Newsapi

liveNewsMedia

NewsAPI.org — fetch top headlines and search a global news archive across 150,000+ sources in 54 countries.

3tools
0msauth
free tier50 calls/day

Tools

top_headlines

Fetch current top news headlines from NewsAPI, filterable by `country` (ISO 2-letter), `category` (business/entertainment/health/science/sports/technology), publisher `sources`, or keyword `q`. Return

No parameters required.

▶Try it
everything

Search the NewsAPI article archive by keyword `q`, source domains, date range (`from`/`to`), or language. Sortable by relevancy, popularity, or publishedAt. Returns article title, description, source,

No parameters required.

▶Try it
sources

Return available NewsAPI publisher sources, filterable by `category`, `language`, and `country`. Returns source id, name, description, URL, and category — use source ids to filter `top_headlines` or `

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/newsapi/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/newsapi/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"top_headlines","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("top_headlines", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("newsapi");