# World News API — MCP server on mcp.ai
> Connect your World News API account and use 8 tools for news and lifestyle straight from your AI agent. Connect with your own API key. The World News API gives you access to thousands of news sources in over 50 languages from over 150 countries.

By: mcp.ai · official
Page: https://mcp.ai/world_news_api

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_world_news_api?ms=1787291400000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/world_news_api/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/world_news_api/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/world_news_api/skill.md
Postman collection (v2.1): https://mcp.ai/world_news_api/postman.json

## Tools
- world_news_api_extract_news(url: string, analyze?: boolean) — Extract structured content from a public article URL. The call costs 2 quota points, plus 2 additional points when analyze is true. Paywalled or login-protected pages may return incomplete content.
- world_news_api_extract_news_links(url: string, prefix?: string, include_subdomains?: boolean) — Extract article links from a news homepage or section page. The call costs 1 quota point, and an empty link list is a successful result.
- world_news_api_generate_rss_feed(url: string, extract_news?: boolean) — Generate an RSS 2.0 XML feed from a public news homepage or section URL. Returns raw XML text. The call costs 1 quota point, plus 0.5 points per feed item when extract_news is true.
- world_news_api_get_geo_coordinates(location: string) — Resolve a place name or address to latitude and longitude for use in Search News location_filter. Costs 1 quota point.
- world_news_api_get_news_by_ids(ids: integer|string[]) — Retrieve full article records for IDs returned by Search News or Get Top News. Costs 0.1 quota points per returned article.
- world_news_api_get_top_news(date?: string, language: string, headlines_only?: boolean, source_country: string, max_news_per_cluster?: integer) — Return relevance-ranked top-news clusters for a country, language, and optional date. Costs 1 quota point; Free accounts can request about one month of history.
- world_news_api_search_news(sort?: string, text?: string, number?: integer, offset?: integer, authors?: string[], entities?: string[], language?: string, categories?: string[], news_sources?: string[], max_sentiment?: number, min_sentiment?: number, sort_direction?: string, source_country?: string, location_filter?: string, text_match_indexes?: string, latest_publish_date?: string, earliest_publish_date?: string) — Search indexed news articles. Provide at least one anchor filter: text, source country, language, news sources, authors, categories, entities, or location. Date, sentiment, and text-match fields only 
- world_news_api_search_news_sources(name: string) — Search monitored news sources by partial name and report matching source URLs and languages. Costs 1 quota point.

## Example prompts
- "What can I do in World News API?"
- "Show me a summary of my World News API account"

## Links
Docs: https://mcp.ai/docs/mcps/world_news_api
Website: https://mcp.ai/mcps/world_news_api