How to Use the News MCP in Windsurf

Q: Can I limit which publishers the News server queries inside Windsurf?

Yes. Cascade can call listsources to see what publishers are available, then filter its queries so it only pulls from the specific outlets you want for your workspace.

Feed real-time global journalism straight into Windsurf so Cascade can build context-aware apps with live market and political updates.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect News MCP to Windsurf

Create your Vinkius account to connect News to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup News with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade Chains Live News Into Code

`get_top_headlines` feeds breaking world events directly into your active workspace. Cascade uses this MCP tool to grab current events, allowing it to instantly update UI dashboards or trigger alerts without waiting for you to copy-paste the latest updates. Just remember not to mix country or category arguments with source filters when prompting the agent to fetch these headlines. When Cascade has this live context, it writes code that reacts to the real world. You ask it to build a financial tracker, and it immediately pulls the latest market-moving stories to populate your database schema.

Target 150,000 Publishers in Windsurf

`list_sources` lets your autonomous agent inspect the full catalog of available media outlets. Cascade reads this directory to decide which publishers to query, ensuring your application pulls from verified, high-quality industry journals rather than random blogs. This means your workspace stays clean of irrelevant noise. The agent checks the publisher list, filters out the junk, and configures your feed settings automatically.

Deep Research with this MCP Server

`search_everything` allows Cascade to run deep queries across millions of historical articles using complex search operators. This MCP Server handles the heavy lifting, letting the agent chain boolean logic like AND, OR, and NOT to sift through years of archives and compile background research for your projects. You don't have to write the search logic yourself. Cascade executes the query, parses the returned article metadata, and writes markdown summaries directly into your project docs.

Setup guide

Set up News MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the News MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my News payment history." If connected, Cascade will call the News tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "news-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by NewsAPI. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect News now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about News MCP in Windsurf

Windsurf connects to the server and lets Cascade autonomously query live articles. When you ask Cascade to build a widget, it calls the tools to fetch real stories and write working code around that actual data.

Yes. Cascade can call `list_sources` to see what publishers are available, then filter its queries so it only pulls from the specific outlets you want for your workspace.

No, Cascade chains these steps on its own. Once you install the MCP Server, the agent plans the search, calls `search_everything`, and uses the results to update your files without asking for approval at every turn.

Open your settings, go to Cascade, and add the server under the `mcpServers` block in `~/.codeium/windsurf/mcp_config.json`. You can also use the built-in MCP Marketplace for a single-click setup.

Your raw search queries and article filters stay strictly inside the V8 sandbox. We do not log the text of your news searches, and the metadata returned from the 150,000 sources is processed in an ephemeral environment that wipes itself clean immediately after the agent finishes its run.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript