Skip to main content
Glama
EventRegistry

newsapi-mcp

NewsAPI.ai MCP Server

npm version npm downloads Tests Node 20+ MCP MIT License

Ask your AI assistant about the news. This Model Context Protocol (MCP) server connects Claude, Cursor, Codex and other AI tools to NewsAPI.ai (Event Registry): 150,000+ sources in 100+ languages, searched as articles, events (clusters of articles about one story) and mentions (sentences that state a happening such as an acquisition or a recall).

Use of the data is subject to the NewsAPI.ai Terms of Service.

Connect in two minutes

You need an Event Registry account (free tier included). No download, no API key: add the server address to your AI tool and log in when it asks.

https://mcp.newsapi.ai/mcp
  1. Open Customize → Connectors → + Add → Add custom connector.

  2. Name: NewsAPI.ai. URL: https://mcp.newsapi.ai/mcp. Save.

  3. Click Connect: a browser window opens at Event Registry. Log in and allow access.

The connector shows as connected. Start a new chat and ask a news question.

claude mcp add --transport http newsapi https://mcp.newsapi.ai/mcp

Ask a news question and Claude Code prompts you to log in, or run /mcp to log in up front. For the research skills (/newsapi:news, /newsapi:due-diligence, …) install the plugin instead.

codex mcp add newsapi --url https://mcp.newsapi.ai/mcp
codex mcp login newsapi

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "newsapi": {
      "url": "https://mcp.newsapi.ai/mcp"
    }
  }
}

Any client that supports Streamable HTTP with OAuth login works: add the URL https://mcp.newsapi.ai/mcp as a remote server and complete the login the client opens. If your client only runs local servers, use the local server.

Your first question

Try one of these in a new chat:

  • What happened with the EU AI Act this week?

  • What are the biggest news stories globally right now?

  • Which companies announced layoffs in the last 7 days?

  • How did German media cover the EU budget talks?

The assistant resolves the names you mention, searches, reviews the relevant article information and answers with links to its sources. How to ask explains what the server can and cannot answer and how to phrase a question for the best result.

Cost and usage

Every account has a budget of API tokens. Looking up names is free; each search or lookup costs a few tokens, and searches that reach further back than the last 30 days cost more. The official rates per request are in the Tokens section of newsapi.ai/plans. Each tool result carries the cost and the remaining balance, and you can ask "how many API tokens do I have left?" at any time.

Troubleshooting

What you see

What to do

"No Event Registry account is linked to this login"

Sign in once at eventregistry.org/login with the same account you used in the login window, then retry.

The login window opens again and again

Your login expired. Disconnect and reconnect the server in your AI tool (Claude: Connectors → NewsAPI.ai → Disconnect, then Connect).

The assistant says the tool is not available

The connector is added but not connected. Open the connector settings and click Connect.

Results stop at 31 days

The server searches the last 31 days unless you name a period. Say "since January" or "in 2025" to widen it.

"Tokens used" grows fast

Event searches and searches older than 31 days cost more. Ask about recent coverage, or name the company or topic precisely so one search is enough.

Related MCP server: gnews-mcp-server

What the assistant can do

Tool

Description

suggest

Look up URIs for entities, sources, categories, locations and event types by name. Used before searching with URI filters.

search

One search tool with kind: articles (by concepts, sources, categories, dates, language, sentiment), events (clusters of related articles about the same happening) or mentions (sentences that state a specific event type such as an acquisition, layoffs, a launch or a recall, with entities and article links). Every kind also returns aggregates (resultType: coverage over time, top sources, top entities, sentiment).

get_article_details

Article information (URL, publisher, date, entities and more) for articles selected from a search.

get_event_details

Summary, concepts and articles of an event.

get_breaking_events

List the events breaking right now, ranked by breaking score.

get_topic_page_articles

Get articles from a saved Topic Page on NewsAPI.ai.

get_topic_page_events

Get events from a saved Topic Page on NewsAPI.ai.

get_api_usage

Check token usage and plan details for the current account.

Claude Code plugin

The repository is a Claude Code plugin: it bundles the hosted MCP server and six research skills, so one install gives Claude Code both.

claude plugin marketplace add EventRegistry/newsapi-mcp
claude plugin install newsapi@newsapi-mcp

Ask a news question or run a skill; Claude Code prompts you to log in with your Event Registry account the first time (or run /mcp to log in up front). Claude Code also picks the right skill from a plain question, without the slash command.

Skill

Ask it for

Example

/newsapi:news

Overviews, article deep dives, happenings, coverage counts, breaking news, topic pages, research reports

"What is happening with the Boeing strike?"

/newsapi:due-diligence

Adverse media screening, ESG controversies, company profiles, key people

"Screen Wirecard for adverse media since 2024."

/newsapi:risk

Supply chain disruptions, country and regional geopolitical risk

"What is the supply chain risk for shipping through the Red Sea?"

/newsapi:markets

Economic indicators and sectors, company and asset analysis

"What drove Nvidia's stock this month?"

/newsapi:political

Policy, legislation, elections, diplomacy

"Where does the EU Digital Markets Act enforcement stand?"

/newsapi:source-analysis

Outlet comparison, sentiment, coverage landscape

"Compare how the BBC and Fox News covered the UN climate summit."

docs/skills.md describes each skill, how they are built and how to use them without the plugin.

Running it yourself

  • Local server: run the server on your own machine with npx newsapi-mcp, log in in the browser or use an API key. For clients without remote-server support, and for developers. See docs/local-server.md.

  • Self-hosting: deploy the hosted server from the Docker image in this repo. See docs/deployment.md.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    A TypeScript-based Model Context Protocol server that fetches, searches, and formats news articles from NewsAPI.org into reader-friendly Markdown digests using LLMs (Gemini and Claude).
    12
    1,348 npm
    MIT
  • F
    license
    Not graded
    quality
    F
    maintenance
    MCP server providing access to the GNews API for fetching news articles and headlines. Supports search and top headlines with advanced filtering by language, country, category, and date.
    1
    -
  • A
    license
    B
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that provides access to global news articles through the News API. It implements a standardized interface for searching news articles, retrieving top headlines, and listing available news sources.
    3
    12
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that exposes real-time AI news intelligence to AI agents and MCP-compatible clients, with 9 deterministic tools for search, trending, signals, and risk analysis.
    Apache 2.0