A community contribution to NewsAPI.ai.Explore the toolkit
newsAPI/agentFREE
GitHubStart for free
PICK YOUR CONNECTION

The news tools exist.
Let’s put them to work.

Bring your NewsAPI.ai key. Choose your assistant, automation, or codebase. Follow the official tool’s setup with a little help from this community guide.

Terminal · Node.js 18+
npx -y newsapi-mcp

Connect your assistant with the official MCP package. Add NEWSAPI_KEY in your client configuration.

Full MCP setup
01 / MCP

A news toolkit
for your assistant.

The official newsapi-mcp package runs locally and connects to NewsAPI.ai. Use a compatible MCP client and Node.js 18 or newer.

Official setup & supported clients
  1. Get your API key. Register at NewsAPI.ai and find your key in your account.
  2. Configure your client. The example below uses the mcpServers format for Claude Desktop and Cursor. Merge it into your client’s MCP configuration; keep any existing servers.
  3. Replace the placeholder locally. Set NEWSAPI_KEY to your key in your own configuration, then restart or reconnect your client.
  4. Try a small request. Ask for recent articles on a specific topic, with dates and original links.
Claude Desktop / Cursor · MCP configuration
{
  "mcpServers": {
    "newsapi": {
      "command": "npx",
      "args": [
        "-y",
        "newsapi-mcp"
      ],
      "env": {
        "NEWSAPI_KEY": "YOUR_API_KEY"
      }
    }
  }
}
This community website never needs your API key. Configure credentials only in your own client, workflow, or server.

Using Claude Code?

Claude Code · add MCP server
claude mcp add newsapi -e NEWSAPI_KEY=YOUR_API_KEY -- npx -y newsapi-mcp

Use the official README for VS Code, Gemini CLI, Windsurf, and other supported clients. Their configuration locations and formats can differ.

What tools does the official server expose?
  • suggest — resolve entities for filters
  • search_articles — retrieve matching reporting
  • search_events — find clusters of related coverage
  • get_topic_page_articles — read saved-topic articles
  • get_topic_page_events — read saved-topic events
  • get_api_usage — inspect account usage
Explore the official news research skill ↗
02 / N8N

Your workflow.
A news connection.

NewsAPI.ai’s n8n guides use native HTTP Request nodes with Event Registry credentials. Start with an n8n Cloud account or your own n8n instance.

Open the official n8n guide
  1. Create a credential in n8n. Open Credentials, add a Custom Auth credential, and name it “Event Registry API”.
  2. Add your API key. Use the JSON below in the credential, replacing the placeholder inside n8n.
  3. Connect an HTTP Request node. Set Authentication to Generic Credential Type, choose Custom Auth, and select your credential.
  4. Follow an official workflow. Start with a manual run. Check your output and account usage before scheduling it.
n8n · Custom Auth credential
{
  "body": {
    "apiKey": "YOUR_API_KEY"
  }
}
01
Content research assistant

Turn a topic into an email research digest.

02
News alert system

Follow the official alert workflow example.

03
Sentiment dashboard

Explore news sentiment in an n8n workflow.

NewsAPI.ai’s allowance covers its API usage. Your n8n hosting and any model services have their own plans.

03 / SDKS & REST

Make room for news
in your codebase.

Use the provider’s libraries or call the REST API from your server. The official sandbox helps you explore filters before writing an integration.

Py
Python SDK

Official package, examples, and source code.

JS
Node.js SDK

Official JavaScript library for articles and events.

{}
REST API sandbox

Build a request and inspect its parameters.

For an OpenRouter-powered app, your application can retrieve news through these tools and pass the results to its chosen model. This site does not provide an OpenRouter app listing or a hosted MCP endpoint.
See the full resource library