How to Use the WorldNewsAPI MCP in OpenAI Agents SDK

Q: Can I check the status of WorldNewsAPI using the OpenAI Agents SDK?

Yes, use the checkapistatus tool. It's a simple function call that verifies if the entire WorldNewsAPI service is operational right now. This confirms connectivity before you run any data retrieval tasks.

Q: Does WorldNewsAPI support top news headlines for specific regions with OpenAI Agents SDK?

Absolutely. The gettopworldnews tool handles this. You just specify the country and language codes, and your agent gets a clean list of the top stories for that region. It’s perfect for localized briefings.

Q: How do I search world news using WorldNewsAPI and the OpenAI Agents SDK?

You call the searchworldnews tool, passing your keyword or phrase as an argument. The MCP Server then handles the querying of its backend. Your agent receives a structured list of articles that match your defined search terms.

Reliable world news data retrieval for your OpenAI Agents SDK production system.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect WorldNewsAPI MCP to OpenAI Agents SDK

Create your Vinkius account to connect WorldNewsAPI to OpenAI Agents SDK 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 WorldNewsAPI with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Check WorldNewsAPI operational status

You can confirm if the service is up and running before triggering a task. The `check_api_status` tool gives an immediate pass/fail report on the API's health. This prevents your agent from wasting cycles trying to connect to a downed endpoint. Before sending complex requests, you should always verify connectivity this way. It’s basic hygiene for any production system.

Search global news by keywords

The `search_world_news` tool pulls articles based on specific phrases or keywords. You feed it a topic, and your agent gets a list of relevant headlines and summaries from around the globe. It handles searching across various sources for you. This is better than just guessing what news might be out there. Your agent can pinpoint exactly what information you need using targeted searches.

Extract content from specific URLs

When you have a direct link, the `extract_news_from_url` tool pulls the article body and metadata directly from that page. You don't just get a headline; you get the actual text content—the good stuff. It cleans up messy web pages into usable data. This means your agent can read deep dives, not just snippets. Use this when you need full context for analysis.

Setup guide

Set up WorldNewsAPI MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all WorldNewsAPI tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives WorldNewsAPI tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate WorldNewsAPI tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="WorldNewsAPI Agent",
            instructions="You have access to WorldNewsAPI tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 WorldNewsAPI. 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 WorldNewsAPI 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 WorldNewsAPI MCP in OpenAI Agents SDK

You pass the MCP Server object directly to your Agent constructor. The system auto-discovers all available tools, like `search_world_news` and `get_top_world_news`. You don't need to write any wrapper code; it just works.

This MCP Server deals with raw world news articles. Specifically, your agent handles structured text and metadata pulled from various global sources. The output is always textual content that your system can process.

Yes, use the `check_api_status` tool. It's a simple function call that verifies if the entire WorldNewsAPI service is operational right now. This confirms connectivity before you run any data retrieval tasks.

Absolutely. The `get_top_world_news` tool handles this. You just specify the country and language codes, and your agent gets a clean list of the top stories for that region. It’s perfect for localized briefings.

You call the `search_world_news` tool, passing your keyword or phrase as an argument. The MCP Server then handles the querying of its backend. Your agent receives a structured list of articles that match your defined search terms.

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