Top News MCP Server

A remote MCP (Model Context Protocol) server deployed on Cloudflare Workers that exposes NewsAPI.org as three tools for any MCP-compatible client (Claude Desktop, Claude.ai, MCP Inspector, etc.).

Tools

| Tool | Description | |------|-------------| | get_top_headlines | Breaking news headlines by country, category, source, or keyword | | search_news | Full-text search across 150,000+ sources with date ranges, sorting, domain filters | | list_sources | Discover available news source IDs for use with the other tools |

Deploy

1. Install dependencies

npm install

2. Set your NewsAPI secret

npx wrangler secret put NEWS_API_KEY
# Paste your API key when prompted

Important: Never hardcode API keys in source files or wrangler.jsonc. The wrangler secret command stores the value encrypted at the edge.

3. Deploy

npx wrangler deploy

The server will be live at:

https://top-news-mcp.<your-account>.workers.dev/mcp

Connect to Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json (macOS/Linux) or %APPDATA%\\Claude\\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "top-news": {
      "command": "npx",
      "args": ["mcp-remote", "https://top-news-mcp.<your-account>.workers.dev/mcp"]
    }
  }
}

Restart Claude Desktop after editing.

Connect to Claude.ai

Use the MCP connector URL directly:

https://top-news-mcp.<your-account>.workers.dev/mcp

Local Development

# Start local dev server
npm start

# In another terminal, test with MCP Inspector
npx @modelcontextprotocol/inspector@latest
# Enter http://localhost:8787/mcp

Project Structure

top-news-mcp/
├── src/
│   ├── index.ts      # Worker entry point + routing
│   ├── mcp.ts        # McpAgent with tool definitions
│   ├── newsapi.ts    # NewsAPI v2 client + formatters
│   └── env.d.ts      # Env type (bindings + secrets)
├── wrangler.jsonc    # Cloudflare config
├── tsconfig.json
└── package.json

Example Usage

Once connected, ask Claude:

"What are today's top US headlines?"
"Search for articles about AI regulation from the last week"
"List all technology news sources in English"
"Find BBC News headlines about climate change"

Top News MCP Server