Skip to content

EventRegistry/newsapi-mcp

Repository files navigation

NewsAPI.ai MCP Server

npm version MIT License

A Model Context Protocol (MCP) server that provides real-time news intelligence using NewsAPI.ai. This server enables LLMs to search articles, track events, and analyze news through natural conversation.

Make sure to follow the NewsAPI.ai Terms of Service.

Requirements

  • Node.js 18 or newer
  • Claude Desktop, Claude Code, VS Code, Cursor, Windsurf or any other MCP client

Quick Start

  1. Get an API key at newsapi.ai/register (free tier: one time 2,000 tokens)
  2. Add to your MCP client (see configuration examples below)

Configuration

Install the NewsAPI.ai MCP server with your client.

The server runs via npx -y newsapi-mcp with your API key in the NEWSAPI_KEY environment variable.

Standard config works in most of the tools:

{
  "mcpServers": {
    "newsapi": {
      "command": "npx",
      "args": ["-y", "newsapi-mcp"],
      "env": {
        "NEWSAPI_KEY": "your_api_key_here"
      }
    }
  }
}

Below are examples for popular MCP clients.

Antigravity

Add via the Antigravity settings or by updating your configuration file:

{
  "mcpServers": {
    "newsapi": {
      "command": "npx",
      "args": ["-y", "newsapi-mcp"],
      "env": {
        "NEWSAPI_KEY": "your_api_key_here"
      }
    }
  }
}
Claude Code
claude mcp add newsapi -e NEWSAPI_KEY=your_api_key_here -- npx -y newsapi-mcp
Claude Desktop

Follow the MCP install guide, use the standard config above.

Gemini CLI

Follow the MCP install guide, use the standard config above.

Qodo Gen

Open Qodo Gen chat panel in VSCode or IntelliJ → Connect more tools → + Add new MCP → Paste the standard config above.

VS Code

Follow the MCP install guide, use the standard config above. You can also install the NewsAPI.ai MCP server using the VS Code CLI:

# For VS Code
code --add-mcp '{"name":"newsapi","command":"npx","args":["-y","newsapi-mcp"],"env":{"NEWSAPI_KEY":"your_api_key_here"}}'

After installation, the NewsAPI.ai MCP server will be available for use with your GitHub Copilot agent in VS Code.

Windsurf

Follow Windsurf MCP documentation. Use the standard config above.

Usage Patterns

Search News Articles

Find articles by keyword, source, author, date, language, sentiment, and more.

  • Find recent articles about the EU AI Act
  • What has Reuters published about climate change this week?
  • Show me negative-sentiment articles about Tesla from the last 3 days
  • Find French-language coverage of the Paris Olympics
  • What are German media reporting about the EU budget?

Track Events

Events are clusters of related articles about the same real-world happening.

  • Find events related to mergers and acquisitions in the tech sector
  • What larger events happened in Slovenia last week?
  • What are the biggest news stories globally this week?

Use Topic Pages

Pull articles or events from saved Topic Pages on NewsAPI.ai.

  • Summarize the latest articles from my cyber-security topic page with URI b220679c-95ff-4e4e-a1fa-ad8b3905b7df

Available Tools

Tool Description
suggest Look up URIs for entities by name. Required before searching with URI filters.
search_articles Search articles by concepts, sources, categories, dates, language, sentiment.
search_events Search events (clusters of related articles about the same happening).
get_topic_page_articles Get articles from a pre-configured topic page on NewsAPI.ai.
get_topic_page_events Get events from a pre-configured topic page on NewsAPI.ai.
get_api_usage Check token usage and plan details for the current API key.

News Research Skill

The skill/ directory contains a /news slash command for Claude Code (CLI and Desktop) that orchestrates multi-step research workflows on top of the MCP tools. It automates the suggest → scan → triage → retrieve pattern and formats findings into structured reports.

/news "What's happening with AI regulation?"

To install, copy the skill/ directory into your project's .claude/skills/ directory. See the skills documentation for details.

Links

About

NewsAPI.ai MCP server

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors