{
"markdown": "# Fast News MCP Server\n\n\n\n\n\nReal-time news search, trending headlines, topic categories, and local news — exposed as MCP tools so your AI agent can query news in plain language. No HTTP boilerplate required.\n\nThe server is hosted by RapidAPI and connects via [`mcp-remote`](https://github.com/geelen/mcp-remote). All you need is a RapidAPI subscription and your API key.\n\n## Demo\n\nSee the Fast News API in action: **[the-dispatcher-demo.vercel.app](https://the-dispatcher-demo.vercel.app/)**\n\n## Get an API Key\n\n1. Subscribe on [RapidAPI](https://rapidapi.com/SemicolonBandit/api/fast-news-with-previews) (free tier available)\n2. Your API key appears on the **Endpoints** tab\n\nEvery request needs two headers:\n\n| Header | Value |\n|--------|-------|\n| `x-rapidapi-key` | Your API key |\n| `x-rapidapi-host` | `fast-news-with-previews.p.rapidapi.com` |\n\n## Quick Start\n\n**Prerequisites:** [Node.js](https://nodejs.org) (for `npx`) and a free [RapidAPI subscription](https://rapidapi.com/SemicolonBandit/api/fast-news-with-previews).\n\nAdd the following to your AI agent's MCP server configuration. Replace `YOUR-API-KEY` with your RapidAPI key.\n\n```json\n{\n \"mcpServers\": {\n \"fast-news\": {\n \"command\": \"npx\",\n \"args\": [\n \"mcp-remote\",\n \"https://mcp.rapidapi.com\",\n \"--header\",\n \"x-api-host: fast-news-with-previews.p.rapidapi.com\",\n \"--header\",\n \"x-api-key: YOUR-API-KEY\"\n ]\n }\n }\n}\n```\n\n> The `mcp-remote` package is installed automatically by `npx`. You don't need to install anything manually.\n\nSee the [per-agent setup instructions](#setup-for-your-ai-agent) below for client-specific details.\n\n\nAlternative: npm package (secondary option)
\n\n> **Prefer the Quick Start above.** Use this only if your setup specifically benefits from a single published package.\n\nThis repository is also published as the npm package [`@wllrdev/fast-news-mcp`](https://www.npmjs.com/package/@wllrdev/fast-news-mcp). It's a thin wrapper around `mcp-remote` that reads your key from the `RAPIDAPI_KEY` environment variable instead of the command line:\n\n```json\n{\n \"mcpServers\": {\n \"fast-news\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@wllrdev/fast-news-mcp\"],\n \"env\": {\n \"RAPIDAPI_KEY\": \"YOUR-API-KEY\"\n }\n }\n }\n}\n```\n\n \n\n## Available Tools\n\nOnce connected, your AI agent has access to these tools:\n\n| Tool | Description |\n|------|-------------|\n| **search_news** | Search any topic with filters for language, country, and timeframe. Supports source diversity and built-in deduplication. |\n| **advanced_search** | Like search_news but with post-fetch controls — include/exclude specific sources, require thumbnails, and change sort order. |\n| **trending_headlines** | Top headlines auto-translated into 40+ languages. Optionally filter by country and timeframe. |\n| **topic_categories** | Browse 11 predefined categories: world, national, business, technology, entertainment, sports, science, health, politics, economy, environment. Combine two categories in one request. |\n| **local_news** | News about a specific city, region, or area. |\n\nFor full parameter documentation, see the [API reference](https://docs.marvelousapi.com/apis/fastnews/docs/endpoints/news).\n\n## Setup for Your AI Agent\n\nFind your client below and expand it for setup steps.\n\n\nClaude Code (docs)
\n\n**Option A — CLI command:**\n\n```bash\nclaude mcp add fast-news -- npx mcp-remote https://mcp.rapidapi.com --header \"x-api-host: fast-news-with-previews.p.rapidapi.com\" --header \"x-api-key: YOUR-API-KEY\"\n```\n\nAdd `--scope user` to make it available globally across all projects.\n\n**Option B — Manual config:**\n\nAdd the [Quick Start](#quick-start) config to your Claude Code MCP settings.\n\n \n\n\nClaude Desktop (docs)
\n\n1. Open Claude Desktop settings\n2. Navigate to **Developer** > **Edit Config**\n3. Paste the [Quick Start](#quick-start) config into `claude_desktop_config.json`\n4. Restart Claude Desktop\n\n \n\n\nCursor (docs)
\n\n1. Open **Cursor Settings** > **MCP** > **New MCP Server**\n2. Paste the [Quick Start](#quick-start) config\n3. Replace `YOUR-API-KEY` with your key\n4. Enable the server\n\n \n\n\nVS Code Copilot (docs)
\n\nAdd the following to your `.vscode/mcp.json`:\n\n```json\n{\n \"servers\": {\n \"fast-news\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\n \"mcp-remote\",\n \"https://mcp.rapidapi.com\",\n \"--header\",\n \"x-api-host: fast-news-with-previews.p.rapidapi.com\",\n \"--header\",\n \"x-api-key: YOUR-API-KEY\"\n ]\n }\n }\n}\n```\n\n \n\n\nWindsurf (docs)
\n\nAdd the [Quick Start](#quick-start) config to your Windsurf MCP config file (`~/.codeium/windsurf/mcp_config.json`).\n\n \n\n\nCline (docs)
\n\n1. Open Cline settings\n2. Go to **MCP** > **Add New MCP Server**\n3. Select **Local** and paste the [Quick Start](#quick-start) config\n\n \n\n\nContinue (docs)
\n\nAdd the [Quick Start](#quick-start) config to your `~/.continue/config.json` under the `mcpServers` key.\n\n \n\n\nOpenCode (docs)
\n\nAdd the following to your `opencode.json`:\n\n```json\n{\n \"mcp\": {\n \"fast-news\": {\n \"type\": \"remote\",\n \"url\": \"https://mcp.rapidapi.com\",\n \"headers\": {\n \"x-api-host\": \"fast-news-with-previews.p.rapidapi.com\",\n \"x-api-key\": \"YOUR-API-KEY\"\n }\n }\n }\n}\n```\n\n \n\n\nCodex CLI (docs)
\n\n```bash\ncodex mcp add fast-news -- npx mcp-remote https://mcp.rapidapi.com --header \"x-api-host: fast-news-with-previews.p.rapidapi.com\" --header \"x-api-key: YOUR-API-KEY\"\n```\n\n \n\n## Usage Examples\n\nOnce connected, try these prompts in your AI agent:\n\n- \"What are the trending headlines right now?\"\n- \"Search for news about artificial intelligence\"\n- \"Find local news about Tokyo\"\n- \"Show me the latest technology news from the past week\"\n- \"Search for climate news from BBC and Reuters only, sorted by newest first\"\n- \"Get trending headlines in German\"\n- \"Find sports and business news combined\"\n- \"Show me health news with thumbnails only from the last 7 days\"\n\nThe agent will use the MCP server to call the appropriate endpoint and return formatted results.\n\n## API Documentation\n\nFor full endpoint documentation, parameters, response formats, and code examples:\n\n- **Overview:** [docs.marvelousapi.com/apis/fastnews](https://docs.marvelousapi.com/apis/fastnews)\n- **Endpoints:** [docs.marvelousapi.com/apis/fastnews/docs/endpoints/news](https://docs.marvelousapi.com/apis/fastnews/docs/endpoints/news)\n- **Error Handling:** [docs.marvelousapi.com/apis/fastnews/docs/error-handling](https://docs.marvelousapi.com/apis/fastnews/docs/error-handling)\n\n## Key Features\n\n- **Source diversity** — no single domain dominates your feed (max 25% per domain)\n- **Built-in deduplication** — near-identical articles are collapsed automatically\n- **40+ languages** — trending and topic searches auto-translate into local queries\n- **Clean previews** — up to 250-character excerpts with thumbnail URLs\n- **Timeframe filters** — last hour, 24h, 7 days, 30 days\n\n## Links\n\n- [Subscribe on RapidAPI](https://rapidapi.com/SemicolonBandit/api/fast-news-with-previews)\n- [API Documentation](https://docs.marvelousapi.com/apis/fastnews)\n- [Live Demo](https://the-dispatcher-demo.vercel.app/)\n- [Discord](https://discord.gg/kEFfEzPqsk)\n\n## License & API Terms\n\nThe configuration and documentation in this repository are MIT licensed.\nThe Fast News API itself is a commercial service hosted on RapidAPI — usage\nis subject to the [RapidAPI Terms of Service](https://rapidapi.com/terms) and\nyour subscription plan. The MIT license does not grant access to the API.\n\n## License\n\n[MIT](LICENSE)\n",
"bytes": 8892,
"sha": "62014a28f090f6baf43c614cef210b59ed53e28145e3bfc2aab346dd2977f8ee",
"repo_slug": "wllrdev/fast-news-mcp",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_wllrdev_fast_news_f5e23413/readme"
}