About AllNewsAPI
AllNewsAPI is an MCP server for searching current and historical news and retrieving headlines. It serves MCP clients that need keyword, date, location, category, publisher, or AI-based filters, and also reports API usage.
Key features
- 01Search current and historical articles
- 02Retrieve filtered top headlines
- 03Filter by date, topic, and publisher
- 04Use sentiment and entity filters
- 05Check plan and remaining quota
Use cases
- 01Find coverage of a topic within a date range
- 02Retrieve headlines for a country or category
- 03Review sentiment and entities in news articles
- 04Check API limits before making requests
MCP support
The server exposes news search, headline retrieval, and usage-checking tools to MCP clients. It is available as a hosted remote server or as a locally run npx package, and requires an API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.allnewsapi.com/mcpclaude mcp add --transport http allnewsapi https://mcp.allnewsapi.com/mcp{"mcpServers":{"allnewsapi":{"type":"http","url":"https://mcp.allnewsapi.com/mcp"}}}Open in Cursor{"servers":{"allnewsapi":{"type":"http","url":"https://mcp.allnewsapi.com/mcp"}}}Open in VS Code{"mcpServers":{"allnewsapi":{"type":"http","url":"https://mcp.allnewsapi.com/mcp"}}}{"mcpServers":{"allnewsapi":{"serverUrl":"https://mcp.allnewsapi.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://mcp.allnewsapi.com/mcpAuth requiredTools
Details
From the project READMEAllNewsAPI MCP
Get access to real-time and historical news data including top headlines from global sources via AllNewsAPI. Supports multiple filter options including keyword search, category, language and more. This Model Context Protocol server lets MCP clients (Claude, Cursor, VS Code, Windsurf, and others) search news articles, fetch top headlines, and check your API usage.
You'll need an API key — get one at allnewsapi.com.
Quick start
Pick one of the two ways to connect.
Hosted (no install)
Point your client at the hosted server and pass your API key in the X-API-Key header:
{
"mcpServers": {
"allnewsapi": {
"type": "remote",
"url": "https://mcp.allnewsapi.com/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY_HERE"
}
}
}
}
Prefer a URL-only setup? Use https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE instead of the header.
The key can be supplied three ways, in this order of precedence: the X-API-Key header, the apikey query parameter, or an Authorization: Bearer YOUR_API_KEY_HERE header (a fallback for clients that only support bearer tokens).
Local (npx)
Runs the server on your machine via npx — no clone or build needed:
{
"mcpServers": {
"allnewsapi": {
"command": "npx",
"args": ["allnewsapi-mcp@latest", "--apikey", "YOUR_API_KEY_HERE"]
}
}
}
You can also supply the key as an ALLNEWSAPI_KEY environment variable instead of --apikey.
Client-specific setup
Claude Desktop
Edit your config (Settings → Developer → Edit Config) and add the local or hosted snippet above. Full guide: modelcontextprotocol.io/quickstart/user.
Cursor
Cursor Settings → MCP → Add new MCP Server. Name it "AllNewsAPI", choose the command type, and enter:
npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE
VS Code
code --add-mcp '{"name":"allnewsapi","command":"npx","args":["allnewsapi-mcp@latest","--apikey","YOUR_API_KEY_HERE"]}'
The server is then available to your GitHub Copilot agent. Full guide: VS Code MCP docs.
Windsurf
Add the local or hosted snippet above to your MCP config. Full guide: Windsurf MCP docs.
Claude Code
Add it from the terminal — local:
claude mcp add allnewsapi -- npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE
Or the hosted server:
claude mcp add --transport http allnewsapi https://mcp.allnewsapi.com/mcp --header "X-API-Key: YOUR_API_KEY_HERE"
Claude Cowork
Cowork runs inside Claude Desktop. Add the hosted server as a custom connector — Customize → Connectors → + — and enter the URL with your key:
https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE
For a local setup, use the Claude Desktop config shown above.
OpenWork
OpenWork is an open-source Cowork alternative with MCP support. Add AllNewsAPI using either the local command (npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE) or the hosted URL above, following OpenWork's MCP configuration.
Any other MCP client: point it at the hosted URL (https://mcp.allnewsapi.com/mcp) or run the npx allnewsapi-mcp@latest command with your API key.
Tools
search-news
Search articles by keyword, date, and filters.
| Parameter | Type | Description |
|---|---|---|
q | string | Keywords to search for |
startDate / endDate | string | Date range (YYYY-MM-DD) |
content | boolean | Include full article content (default: false) |
lang | string | Language code(s), e.g. en, fr |
country | string | Country code(s), e.g. us, gb |
region | string | Region(s), e.g. americas, europe |
category | string | Category/categories, e.g. business |
max | number | Number of articles, 1–100 (default: 5) |
page | number | Page number (default: 1) |
attributes | string | Where to match keywords: title, description, content |
sortby | string | publishedAt or relevance |
publisher | string | Filter by publisher(s) |
ai_sentiment | string | positive, negative, or neutral |
ai_entity_name | string | Named entity, e.g. Apple |
ai_entity_type | string | Entity type, e.g. person, organization, location |
headlines
Get top headlines, optionally filtered.
| Parameter | Type | Description |
|---|---|---|
country | string | Country code(s), e.g. us, gb |
category | string | Category, e.g. technology |
lang | string | Language code, e.g. en |
max | number | Number of articles, 1–100 (default: 5) |
ai_sentiment | string | positive, negative, or neutral |
ai_entity_name | string | Named entity, e.g. Apple |
ai_entity_type | string | Entity type, e.g. person, organization, location |
usage
Check your plan, request limits, and remaining quota. No parameters.
Plan note: Advanced filters —
country,region,category,publisher,lang,attributes, andsortby— require a paid plan. On the free plan, usesearch-newswithqandmax. See pricing.
AI filtering
search-news and headlines accept AI-analyzed filters:
ai_sentiment— overall article sentiment (positive,negative,neutral)ai_entity_name— a named entity in the article (e.g.United Nations)ai_entity_type— entity category (person,organization,location)
Returned articles may also include AI sentiment scores, detected entities, and a short AI summary when available.
Example prompts
- "Get me the latest technology news from the US"
- "Find articles about climate change from European sources"
- "Show me top business headlines from the past week"
- "Find positive news about renewable energy"
- "Show me articles mentioning Apple as an organization"
- "Check my API usage and remaining quota"
Supported values
Full lists of accepted values live in the AllNewsAPI docs:
License
MIT © AllNewsAPI — see LICENSE for details.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.