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. NewsAPI.ai MCP Server connects Claude, Cursor, Codex and other AI tools to NewsAPI.ai, a news API developed and operated by Event Registry: 150,000+ sources in 50+ 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).
Homepage · Documentation · Register · Terms of Service
Use of the data is subject to the NewsAPI.ai Terms of Service.
Connect in two minutes
You need a NewsAPI.ai 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.
If Claude answers from web search instead, check that the connector is switched on for
the chat: in the chat box open + → Connectors and make sure NewsAPI.ai is on
(connectors are usually on by default):

claude mcp add --transport http --scope user newsapi https://mcp.newsapi.ai/mcp--scope user makes the server available in every project; drop it to add it to the
current project only. Ask a news question and Claude Code prompts you to log in, or run
/mcp to log in up front. The first tool call asks for permission: choose "always allow"
(or add mcp__newsapi under /permissions) so later calls run without a prompt. 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 Desktop: Connectors → NewsAPI.ai → Disconnect, then Connect; Claude Code: |
The assistant says the tool is not available, or answers from web search | The connector is added but not connected, or it is switched off for this chat. Open the connector settings and click Connect, then check + → Connectors in the chat box. |
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, or a company by stock ticker or ISIN ( |
| 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." |
The same skills ship as zips for Claude Desktop and claude.ai on every release (one zip per skill, uploaded under Customize > Skills).
docs/skills.md describes each skill, how they are built and how to use them in Claude Desktop or without the plugin.
Which setup do I need?
You use | Server | Research skills |
Claude Desktop or claude.ai | Hosted connector (above), or the local server | Upload the skill zips from the latest release |
Claude Code | The plugin brings the hosted server; or add the hosted or local server yourself | The plugin's six skills; they also work with a local server named |
Codex, Cursor, other clients | Hosted connector (above), or the local server | Not available |
Pick one server per client. If you install the plugin and also add a local newsapi
server, Claude Code shows both under /mcp and asks you to log in to each; disable the
one you do not use there.
Updating
Plugin:
claude plugin update newsapi@newsapi-mcp.Local server:
npxcaches the package, so putnewsapi-mcp@latestin the client configuration, or runnpx -y newsapi-mcp@latestonce.Desktop skills: download the zips of the new release and upload them again; the upload replaces the skill of the same name.
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).12980 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