# NewsAPI — MCP server on mcp.ai
> Connect your NewsAPI account and use 4 tools for news and lifestyle straight from your AI agent. Connect with your own API key. News API is a simple HTTP REST API for searching and retrieving live articles from all over the web.

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_news_api?ms=1787296080000
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/news_api/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/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/news_api/skill.md
Postman collection (v2.1): https://mcp.ai/news_api/postman.json

## Tools
- news_api_get_everything(q?: string, to?: string, from?: string, page?: integer, sortBy?: string, domains?: string, sources?: string, language?: string, pageSize?: integer, qInTitle?: string, excludeDomains?: string) — Tool to search through every article published by over 150,000 sources. At least one of q, sources, language, or domains must be set or the API returns a parametersMissing error. Historical date range
- news_api_get_sources(country?: string, category?: string, language?: string) — Tool to fetch available news sources. Use when you need to retrieve a list of publishers by optional filters like category, language, or country. Source IDs returned here are the only valid IDs for fi
- news_api_get_top_headlines(q?: string, page?: integer, country?: string, sources?: string, category?: string, pageSize?: integer) — Tool to retrieve live top and breaking headlines; does not support historical or date-bounded queries (use NEWS_API_GET_EVERYTHING for past date ranges). Results favor major outlets; use NEWS_API_GET_
- news_api_get_v1_articles(sortBy?: string, source: string) — Tool to fetch live article metadata from a news source using the legacy v1 API. Use when you need headlines from a specific source identifier. This v1 endpoint has been superseded by /v2/top-headlines

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

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