# World News API — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_world_news_api?ms=1787291340000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `world_news_api_extract_news`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/world_news_api`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/world_news_api/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/world_news_api/extract/news` — 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.
  - body: { url: string, analyze?: boolean }
- `POST https://api.mcp.ai/api/world_news_api/extract/news/links` — 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.
  - body: { url: string, prefix?: string, include_subdomains?: boolean }
- `POST https://api.mcp.ai/api/world_news_api/generate/rss/feed` — 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.
  - body: { url: string, extract_news?: boolean }
- `POST https://api.mcp.ai/api/world_news_api/get/geo/coordinates` — Resolve a place name or address to latitude and longitude for use in Search News location_filter. Costs 1 quota point.
  - body: { location: string }
- `POST https://api.mcp.ai/api/world_news_api/get/news/by/ids` — Retrieve full article records for IDs returned by Search News or Get Top News. Costs 0.1 quota points per returned article.
  - body: { ids: integer|string[] }
- `POST https://api.mcp.ai/api/world_news_api/get/top/news` — 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.
  - body: { date?: string, language: string, headlines_only?: boolean, source_country: string, max_news_per_cluster?: integer }
- `POST https://api.mcp.ai/api/world_news_api/search/news` — 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 
  - body: { 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 }
- `POST https://api.mcp.ai/api/world_news_api/search/news/sources` — Search monitored news sources by partial name and report matching source URLs and languages. Costs 1 quota point.
  - body: { name: string }

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

## More
- Page: https://mcp.ai/world_news_api
- Agent spec (llms.txt): https://mcp.ai/world_news_api/llms.txt
- Postman collection: https://mcp.ai/world_news_api/postman.json