AllNewsAPI

npm AllNewsAPI/mcp-server MCP server

AllNewsAPI/mcp-server MCP server

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

npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE

code --add-mcp '{"name":"allnewsapi","command":"npx","args":["allnewsapi-mcp@latest","--apikey","YOUR_API_KEY_HERE"]}'

claude mcp add allnewsapi -- npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE

claude mcp add --transport http allnewsapi https://mcp.allnewsapi.com/mcp --header "X-API-Key: YOUR_API_KEY_HERE"

https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE

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.

headlines

Get top headlines, optionally filtered.

usage

Check your plan, request limits, and remaining quota. No parameters.

Plan note: Advanced filters — country, region, category, publisher, lang, attributes, and sortby — require a paid plan. On the free plan, use search-news with q and max. 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:

• Countries
• Languages
• Categories
• Regions

License

MIT © AllNewsAPI — see LICENSE for details.