# WorldNewsAPI MCP for AI Agents AI Agent Connect > WorldNewsAPI lets your AI agent pull real-time global news, audit top headlines by country, and extract metadata from specific URLs. It turns your agent into a news analyst that can monitor geopolitical shifts or market trends without you having to browse multiple news portals manually. ## Overview - **Category:** artificial-intelligence - **Price:** Free - **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect - **Tags:** news-aggregation, media-monitoring, real-time-data, journalism-api, content-metadata, global-news ## Description Stop jumping between tabs to see what's happening in different regions. With WorldNewsAPI, you give your agent the ability to act as a dedicated media researcher. Instead of copy-pasting headlines into a doc, you just ask your agent to find recent stories about a specific topic or summarize the top news in a country like Japan or Brazil. It pulls the latest data directly into your conversation, making it easy to spot trends or verify facts quickly. You'll find this especially useful if you're building a research workflow where staying on top of global events is a constant requirement. Because it connects through the Vinkius catalog, you can plug it into your existing setup and start querying the world's news feed immediately. It handles the heavy lifting of finding and organizing the data so you can focus on the actual analysis. ## Tools ### extract_news_from_url Extract article content and metadata from a specific news URL. It pulls the text and details from a link so you don't have to visit the page. ### get_top_world_news Get top news headlines for a specific country and language. This lets you see the lead stories in any region instantly. ### search_world_news Search for world news articles by keyword or phrase. It finds relevant stories across the globe based on your specific input. ### check_api_status Check if the WorldNews service is operational. Use this to ensure your news feed is active before starting a big research task. ## Prompt Examples **Prompt:** ``` What are the top stories in Germany right now in German? ``` **Response:** ``` ### Top Stories in Germany | Headline | Source | Summary | | :--- | :--- | :--- | | **New Energy Policy Passed** | Berlin Gazette | The government approved a new plan to increase solar capacity by 20%. | **Tech Hub Expansion** | Munich Daily | A major expansion of the city's tech district was announced today. *Source metadata indicates these are high-authority local reports.* ``` **Prompt:** ``` Find recent news about the new shipping regulations in the Suez Canal. ``` **Response:** ``` I found several recent articles regarding shipping regulations in the Suez Canal: * **Regulation Update 2024** (Published 2 days ago) * **Impact on Global Trade** (Published 4 days ago) * **New Safety Protocols** (Published 1 week ago) Would you like me to extract the full content from any of these links? ``` **Prompt:** ``` Summarize this article for me: https://example.com/news/global-trade-update ``` **Response:** ``` I've extracted the content from that link. Here is a summary: **Key Takeaways:** * **Trade Routes:** New agreements are set to bypass certain bottlenecks. * **Impact:** Expected to reduce shipping costs by 5% for major carriers. * **Timeline:** Implementation begins in Q3. **Metadata:** * **Author:** Jane Doe * **Date:** October 12, 2023 ``` ## Capabilities ### Search real-time news Find global news articles using specific keywords or phrases. ### Audit regional headlines Retrieve the top stories for any country and language instantly. ### Extract URL content Pull full article text and metadata from a specific news link. ### Identify source metadata Get detailed information to help categorize news styles and sources. ### Monitor service status Check if the news service is active and ready for your workflow. ## Use Cases ### Regional sentiment analysis A journalist needs to know the sentiment of news in France. They ask the agent to get the top headlines for France in French and summarize the main themes. ### Company news tracking A researcher is looking for a specific company's news. They use search_world_news for the company name and ask the agent to list the most recent articles. ### Rapid fact verification A policy lead needs to verify a specific report. They provide a link and have the agent use extract_news_from_url to pull the full text and publication date. ### Geopolitical trend monitoring A market analyst is tracking a tech trend. They ask the agent to find news on semiconductors and audit the top stories for the US and Taiwan. ## Benefits - Skip the manual search by using search_world_news to find relevant articles across multiple countries instantly. - Get a bird's eye view of any region using get_top_world_news to see what's trending in specific languages. - Save time on deep dives by using extract_news_from_url to pull content directly into your workspace without leaving your chat. - Identify source patterns and stylistic markers through metadata extraction to better understand media bias. - Keep your workflow running smoothly by using check_api_status to verify the connection is active before you start. ## How It Works The bottom line is you get a real-time global news feed piped directly into your AI agent's toolkit. 1. Subscribe to this Connector and grab your WorldNewsAPI Key. 2. Add the key to your configuration in Claude, Cursor, or your preferred client. 3. Ask your agent to find news, audit headlines, or extract data from links. ## Frequently Asked Questions **Can WorldNewsAPI find news in different languages?** Yes, it can pull top stories for specific countries and languages, making it easy to monitor news in your target markets. **How does WorldNewsAPI help with media research?** It lets your agent pull metadata and content from news links automatically, saving you from manual browsing and copy-pasting. **Can I use WorldNewsAPI to track specific global events?** Yes, you can search by keyword to find news on specific topics like climate change or semiconductors across the globe. **Does WorldNewsAPI work with my current AI client?** Yes, it connects to Claude, Cursor, and other MCP-compatible clients to bring news data into your existing workflow. **Can I get the full text of a news story using WorldNewsAPI?** Yes, you can provide a URL and have your agent extract the content and metadata so you can read it directly in your chat. **Is WorldNewsAPI good for monitoring geopolitical shifts?** It is ideal for that because it can audit top stories by country to show you real-time regional trends and news flow. **How do I find my WorldNewsAPI Key?** Sign up for an account at [**worldnewsapi.com**](https://worldnewsapi.com/), and you will find your API Key in your dashboard. Copy and paste it below. **Can I filter news by country?** Yes. Use the `get_top_world_news` tool and provide the 2-letter country code (e.g., 'us' or 'br'). Your agent will return matching top stories instantly. **Does it support article extraction?** Yes. The `extract_news_from_url` tool retrieves the full text and metadata for a news article from any specified URL in the database.