Connect World News API to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
What you can do with the World News API MCP server
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the top news tool in World News API
Use the geo coordinates lookup tool in World News API
Use the retrieve articles tool in World News API
Use the newspaper front page tool in World News API
Use the extract news links tool in World News API
Use the search news sources tool in World News API
Supported Tools
top_news
Top News
Retrieve the top/breaking news headlines for a specific country and language. News articles are clustered by topic — the more sources covering the same story, the higher it ranks. Useful for getting an overview of the day's most important stories.
geo_coordinates
Geo Coordinates Lookup
Retrieve geographic coordinates (latitude and longitude) for a location name. Use the returned coordinates with the Search News tool's **locationFilter** parameter to find news mentioning locations within a given radius. Format: `latitude,longitude,radiusKm`.
retrieve_articles
Retrieve Articles
Fetch the full details of one or more news articles by their IDs. Article IDs are obtained from other tools like Search News or Top News. Returns complete article data including title, text, summary, images, videos, authors, publish date, sentiment, and category.
newspaper_front_page
Newspaper Front Page
Retrieve the front page image of a newspaper publication. Access front pages from over 6,000 publications across 125+ countries. Filter by country, publication name, and date. Useful for getting a visual snapshot of what matters in a given country on a given day.
extract_news_links
Extract News Links
Extract news article links from a given news website URL. Useful for discovering all articles published on a particular news source. Optionally filter links by a URL prefix or include sub-domain links.
search_news_sources
Search News Sources
Search for available news sources monitored by the World News API. Check if a specific publication or news website is indexed and available for use in news searches. Returns matching source names, URLs, and languages.
extract_news
Extract News from URL
Extract structured news article data from any given URL. Returns the article's title, full text, images (with captions and dimensions), videos (with summary, duration, thumbnail), publish date, authors, language, and source country and sentiment when available. Optionally performs named entity analysis on the content.
search_news
Search News
Search and filter news articles from thousands of sources across 210+ countries and 86+ languages. Supports keyword search, semantic entity matching (e.g. `ORG:Tesla`, `PER:Elon Musk`, `Location:USA`), date range filtering, sentiment filtering, geo-located search by coordinates and radius, and filtering by category, language, source country, author, and news source. Results can be sorted by relevance or publish time.
website_to_rss
Website to RSS Feed
Prepare a downloadable RSS feed for a news website or section page.
Enable World News API in Metorial. In your Metorial portal, enable the World News API MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load World News API tools.
Enable World News API in Metorial. In your Metorial portal, enable the World News API MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load World News API tools.
Enable World News API in Metorial. In your Metorial portal, enable the World News API MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load World News API tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable World News API in Metorial. In your Metorial portal, enable the World News API MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load World News API tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable World News API in Metorial. In your Metorial portal, enable the World News API MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its World News API tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run World News API through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give World News API and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use World News API tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Search and retrieve news articles, browse top stories, extract article content from URLs, discover sources, look up geographic coordinates, and prepare newspaper front page images and RSS feeds for download.
Frequently asked questions
Common questions about connecting World News API to AI agents with Metorial.
How many tools does the World News API MCP server have?
The World News API MCP server exposes 9 tools, including Top News, Geo Coordinates Lookup, Retrieve Articles. Each one is governed and traced through Metorial.
Does the World News API MCP server support triggers?
World News API exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the World News API MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the World News API MCP server through the same Metorial URL.
How do I give only some teams access to World News API?
Use role-based access control to decide which teams, users, and agents can use World News API and which of its tools they can call.
Can I self-host the World News API MCP server?
Yes. Metorial is open source, so you can run the World News API MCP server yourself or use the hosted gateway.
Connect World News API to production AI agents
See how Metorial gives your team governed access to World News API, with tracing and security controls built in.