AllNewsAPI MCP server

AllNewsAPI 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=YOURAPIKEY_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 YOURAPIKEY_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

Shortened. The full README is on GitHub.