newsapi-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@newsapi-mcpFind recent articles about the EU AI Act"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
NewsAPI.ai MCP Server
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/mcpOpen Customize → Connectors → + Add → Add custom connector.
Name:
NewsAPI.ai. URL:https://mcp.newsapi.ai/mcp. Save.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/mcpAsk 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 newsapiAdd 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 |
| Look up URIs for entities, sources, categories, locations and event types by name. Used before searching with URI filters. |
| One search tool with |
| Article information (URL, publisher, date, entities and more) for articles selected from a search. |
| Summary, concepts and articles of an event. |
| List the events breaking right now, ranked by breaking score. |
| Get articles from a saved Topic Page on NewsAPI.ai. |
| Get events from a saved Topic Page on NewsAPI.ai. |
| 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-mcpAsk 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 |
| Overviews, article deep dives, happenings, coverage counts, breaking news, topic pages, research reports | "What is happening with the Boeing strike?" |
| Adverse media screening, ESG controversies, company profiles, key people | "Screen Wirecard for adverse media since 2024." |
| Supply chain disruptions, country and regional geopolitical risk | "What is the supply chain risk for shipping through the Red Sea?" |
| Economic indicators and sectors, company and asset analysis | "What drove Nvidia's stock this month?" |
| Policy, legislation, elections, diplomacy | "Where does the EU Digital Markets Act enforcement stand?" |
| 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.
Links
This server cannot be deployed
Maintenance
Related MCP Connectors
The only News based AI MCP your agents will ever need — custom categories, global regions, and time-scoped results in one tool. We use multi-vector & sparse-hybrid search to search through thousands of articles across the world to find the exact news you're looking for.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Google News headlines, sources, and links via the Apify Google News API, hosted MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceA 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).121,348 npmMIT
- FlicenseNot gradedqualityFmaintenanceMCP 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-
- AlicenseBqualityDmaintenanceA 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.312MIT
- AlicenseNot gradedqualityDmaintenanceA 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