How to Use the NewsAPI MCP in Mastra AI

Q: How do I install the NewsAPI tools in Mastra AI?

Run npm install @mastra/mcp@latest. Instantiate the MCPClient with your Vinkius server URL, call mcpClient.listTools(), and spread the resulting tools directly into your Mastra Agent configuration.

Q: Does Mastra support human approval for NewsAPI actions?

Yes. You can set requireToolApproval on tools like searcharticles. Mastra pauses the workflow, waits for your explicit approval, and then executes the search.

Build resilient news monitoring workflows in Mastra AI using the NewsAPI MCP integration.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect NewsAPI MCP to Mastra AI

Create your Vinkius account to connect NewsAPI to Mastra AI 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 NewsAPI with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Orchestrate News Workflows with this MCP Server

This MCP Server connects your agents to global news APIs backed by automatic retries. News endpoints fail, rate limit, and timeout. Mastra handles these realities natively. Connect this server to your Mastra setup, and your workflows gain access to real-time data without breaking when traffic spikes. You can build a workflow that triggers `get_recent_articles` every hour. If the endpoint stalls, the framework catches the error and tries again. Your automated news digests go out on time, every time.

Conditional Branching for Breaking Events

The `get_headlines_by_category` tool allows your Mastra workflow to spot market-moving updates instantly. Stop writing linear scripts for unpredictable events. You can configure an agent to watch for specific triggers in the daily news cycle. If the agent spots a major story, the workflow branches. It instantly triggers `search_articles` to pull deep historical context, then formats a report. If the headlines are quiet, it halts execution and saves you compute.

Filter the Noise with Source Targeting

The `list_sources` tool identifies credible news outlets before your agents pull data. Finding signal in 150,000 sources requires precision. Give your Mastra agents this tool so they can map out the media environment programmatically. Once the agent knows the source IDs, it uses `get_headlines_by_source` to pull exact stories. You can even enforce human-in-the-loop approval before the agent publishes the final brief.

Setup guide

Set up NewsAPI MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All NewsAPI tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "newsapi-mcp-client",
  servers: {
    "newsapi-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "NewsAPI Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to NewsAPI tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent NewsAPI transactions"
);
console.log(result.text);

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 NewsAPI 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 NewsAPI MCP in Mastra AI

Run `npm install @mastra/mcp@latest`. Instantiate the `MCPClient` with your Vinkius server URL, call `mcpClient.listTools()`, and spread the resulting tools directly into your Mastra Agent configuration.

Yes. Mastra's built-in workflow engine automatically applies exponential backoff if your agent hits a rate limit while calling `get_popular_articles` or any other endpoint.

Set up a Mastra workflow with a conditional branch. Have step one call `search_headlines`. If the results contain specific keywords, branch to step two and execute a broader `search_articles` query.

Yes. You can set `requireToolApproval` on tools like `search_articles`. Mastra pauses the workflow, waits for your explicit approval, and then executes the search.

The server handles search terms and language parameters. Vinkius isolates every single execution in a zero-trust sandbox. Once the news data ships back to your Mastra client, the environment is wiped clean. No logs of your search history survive.

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