NewsAPI Connector for AI agents.

Q: Can I search for news articles from a specific date range?

Yes! Use the searcheverything tool and provide the from and to parameters in ISO 8601 format (e.g., 2023-12-01) to restrict your search to a specific timeframe.

Q: How do I find the top business headlines in a specific country like the UK?

You can use the gettopheadlines tool. Set the country parameter to 'gb' and the category parameter to 'business' to get the latest relevant news.

3 live capabilities

Pull live headlines and search millions of articles for real-time media monitoring.

Live agent request NewsAPI / Connector

Waiting for input…

AI Agent

Why people use NewsAPI

News for Real-Time Media Monitoring and News Retrieval

With this News MCP, your agent does that work in seconds. It pulls the data, organizes it, and gives you the highlights immediately so you can get straight to the actual work.

What Vinkius changes

You get real-time news data fed directly into your AI client.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Competitor Tracking

An analyst asks the agent to find every mention of a rival brand in the last 48 hours using search_everything.
Real-world use case 02

Content Planning

A newsletter writer asks for the top three tech headlines in France to draft a morning update using get_top_headlines.
Real-world use case 03

Market Research

A researcher wants a list of articles about quantum computing breakthroughs from the last month using search_everything.

Complete set · 3capabilities

The complete NewsAPI capability set.

These are the exact actions your AI can choose when you ask it to work with NewsAPI.

Capability set01 / 01

01—03

3 capabilities in this set.

Part of 3 available through NewsAPI.

01 Capability
Search everything
Search millions of articles using advanced operators like AND, OR, and NOT. It handles specific keywords and date filters across 150,000 sources.
02 Capability
List sources
Get a list of all publishers available for top headlines. This helps you identify which news outlets your agent can pull from.
03 Capability
Get top headlines
Fetch live top and breaking headlines from specific countries or categories. It gives you immediate access to what's happening right now.

Set up in minutes

One URL. Then ask NewsAPI to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use NewsAPI from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_FNfbzPhCV0VamAYNxSLHIarH14ybEuaMpbWHJqP5/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it NewsAPI, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable NewsAPI for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_FNfbzPhCV0VamAYNxSLHIarH14ybEuaMpbWHJqP5/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the NewsAPI URL.
Step 03

Save and start

Save the connection and enable NewsAPI in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "news": {
      "url": "https://edge.vinkius.com/vk_preview_FNfbzPhCV0VamAYNxSLHIarH14ybEuaMpbWHJqP5/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using NewsAPI

Open Agent mode in chat and ask: "Using NewsAPI, help me...". 3 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "news": {
      "url": "https://edge.vinkius.com/vk_preview_FNfbzPhCV0VamAYNxSLHIarH14ybEuaMpbWHJqP5/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using NewsAPI

Ask Copilot: "Using NewsAPI, help me...". 3 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "news": {
      "url": "https://edge.vinkius.com/vk_preview_FNfbzPhCV0VamAYNxSLHIarH14ybEuaMpbWHJqP5/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using NewsAPI

Open Cascade and ask: "Using NewsAPI, help me...". 3 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "news": {
      "url": "https://edge.vinkius.com/vk_preview_FNfbzPhCV0VamAYNxSLHIarH14ybEuaMpbWHJqP5/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using NewsAPI

Ask Cline: "Using NewsAPI, help me...". 3 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add news --transport http "https://edge.vinkius.com/vk_preview_FNfbzPhCV0VamAYNxSLHIarH14ybEuaMpbWHJqP5/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using NewsAPI

Ask Claude: "Using NewsAPI, show me...". 3 tools are ready

Where the request belongs

Work NewsAPI can move forward.

Built around the request

This is for researchers, content creators, and analysts who need to stay on top of a fast-moving news cycle without spending hours on Google News.

Market Researcher

Monitors competitor mentions and industry shifts across thousands of domains to write reports.

Content Creator

Finds verified sources and trending stories to draft newsletters or social media updates.

Data Analyst

Aggregates news sentiment and volume for specific topics to identify emerging trends.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 6 capabilities

Currents

Access real-time global news and search millions of articles directly from your AI agent using the Currents API.

View Connector

02 4 capabilities

WorldNewsAPI

Search world news. audit articles, top stories, and sources via AI.

View Connector

03 10 capabilities

NewsAPI

Search breaking news and historical articles from 150,000+ sources via NewsAPI.org.

View Connector

04 2 capabilities

Mediastack

Access real-time and historical news articles from over 7,500 sources worldwide directly through your AI agent.

View Connector

05 4 capabilities

NewsCatcher

Search millions of news articles in real-time with AI clustering and topic tracking.

View Connector

06 16 capabilities

Stanford GDELT

Analyze global news events and media coverage in real time with the world largest open dataset of human society.

View Connector

Bring your own AI

Change the model, client or framework. Keep NewsAPI connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about NewsAPI.

The practical details behind the request, access and result.

Can the News MCP find articles from specific countries?

Yes, it can pull headlines and articles from around the world. You can specify a country or region to see what is happening in a specific market.

How many news sources does this Connector actually cover?

It connects to over 150,000 news sources. This includes major global outlets, local newspapers, and niche blogs.

Can I use the News MCP to track my competitors?

Absolutely. You can ask your agent to search for specific company names or product mentions across the entire news database.

Does the News MCP provide live breaking news?

Yes, it provides access to live headlines. Your agent can pull the most recent stories as they happen.

Can I filter news by specific categories like tech or business?

Yes, you can filter by category. This helps you ignore the noise and focus on the specific industry news that matters to you.

Is the News MCP good for finding niche blog posts?

Yes, it covers a wide range of publishers. It's great for finding specialized information that might not show up on the main front pages of major sites.

Can I search for news articles from a specific date range?

Yes! Use the search_everything capability and provide the from and to parameters in ISO 8601 format (e.g., 2023-12-01) to restrict your search to a specific timeframe.

How do I find the top business headlines in a specific country like the UK?

You can use the get_top_headlines capability. Set the country parameter to 'gb' and the category parameter to 'business' to get the latest relevant news.

Is it possible to see which news sources are available for a specific language?

Absolutely. Use the list_sources capability and specify the language parameter (e.g., 'en', 'pt', 'fr') to retrieve a list of all supported publishers for that language.

One connection away

Give your agent a direct line to NewsAPI.

Connect NewsAPI once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

News for Real-Time Media Monitoring and News Retrieval

You get real-time news data fed directly into your AI client.

Competitor Tracking

Content Planning

Market Research

Search everything

List sources

Get top headlines

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using NewsAPI

Create MCP config

Add the server config

Enable Agent mode

Start using NewsAPI

Open MCP Settings

Add the server

Save and reload

Start using NewsAPI

Open Cline MCP Settings

Add remote server

Enable the server

Start using NewsAPI

Install Claude Code

Add the Connector

Verify the connection

Start using NewsAPI

Market Researcher

Content Creator

Data Analyst

Currents

WorldNewsAPI

NewsAPI

Mediastack

NewsCatcher

Stanford GDELT

Give your agent a direct line to NewsAPI.