{
  "markdown": "# AllNewsAPI MCP\n\n[![npm](https://img.shields.io/npm/v/allnewsapi-mcp)](https://www.npmjs.com/package/allnewsapi-mcp)\n[![AllNewsAPI/mcp-server MCP server](https://glama.ai/mcp/servers/AllNewsAPI/mcp-server/badges/score.svg)](https://glama.ai/mcp/servers/AllNewsAPI/mcp-server)\n\n[![AllNewsAPI/mcp-server MCP server](https://glama.ai/mcp/servers/AllNewsAPI/mcp-server/badges/card.svg)](https://glama.ai/mcp/servers/AllNewsAPI/mcp-server)\n\nGet access to real-time and historical news data including top headlines from global sources via [AllNewsAPI](https://allnewsapi.com/). Supports multiple filter options including keyword search, category, language and more. This [Model Context Protocol](https://modelcontextprotocol.io/) server lets MCP clients (Claude, Cursor, VS Code, Windsurf, and others) search news articles, fetch top headlines, and check your API usage.\n\nYou'll need an API key — get one at [allnewsapi.com](https://allnewsapi.com/).\n\n## Quick start\n\nPick one of the two ways to connect.\n\n### Hosted (no install)\n\nPoint your client at the hosted server and pass your API key in the `X-API-Key` header:\n\n```json\n{\n  \"mcpServers\": {\n    \"allnewsapi\": {\n      \"type\": \"remote\",\n      \"url\": \"https://mcp.allnewsapi.com/mcp\",\n      \"headers\": {\n        \"X-API-Key\": \"YOUR_API_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\nPrefer a URL-only setup? Use `https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE` instead of the header.\n\nThe key can be supplied three ways, in this order of precedence: the `X-API-Key` header, the `apikey` query parameter, or an `Authorization: Bearer YOUR_API_KEY_HERE` header (a fallback for clients that only support bearer tokens).\n\n### Local (npx)\n\nRuns the server on your machine via `npx` — no clone or build needed:\n\n```json\n{\n  \"mcpServers\": {\n    \"allnewsapi\": {\n      \"command\": \"npx\",\n      \"args\": [\"allnewsapi-mcp@latest\", \"--apikey\", \"YOUR_API_KEY_HERE\"]\n    }\n  }\n}\n```\n\nYou can also supply the key as an `ALLNEWSAPI_KEY` environment variable instead of `--apikey`.\n\n### Client-specific setup\n\n<details>\n<summary>Claude Desktop</summary>\n\nEdit your config (Settings → Developer → Edit Config) and add the local or hosted snippet above. Full guide: [modelcontextprotocol.io/quickstart/user](https://modelcontextprotocol.io/quickstart/user).\n\n</details>\n\n<details>\n<summary>Cursor</summary>\n\n`Cursor Settings` → `MCP` → `Add new MCP Server`. Name it \"AllNewsAPI\", choose the `command` type, and enter:\n\n```\nnpx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE\n```\n\n</details>\n\n<details>\n<summary>VS Code</summary>\n\n```bash\ncode --add-mcp '{\"name\":\"allnewsapi\",\"command\":\"npx\",\"args\":[\"allnewsapi-mcp@latest\",\"--apikey\",\"YOUR_API_KEY_HERE\"]}'\n```\n\nThe server is then available to your GitHub Copilot agent. Full guide: [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server).\n\n</details>\n\n<details>\n<summary>Windsurf</summary>\n\nAdd the local or hosted snippet above to your MCP config. Full guide: [Windsurf MCP docs](https://docs.windsurf.com/windsurf/cascade/mcp).\n\n</details>\n\n<details>\n<summary>Claude Code</summary>\n\nAdd it from the terminal — local:\n\n```bash\nclaude mcp add allnewsapi -- npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE\n```\n\nOr the hosted server:\n\n```bash\nclaude mcp add --transport http allnewsapi https://mcp.allnewsapi.com/mcp --header \"X-API-Key: YOUR_API_KEY_HERE\"\n```\n\n</details>\n\n<details>\n<summary>Claude Cowork</summary>\n\nCowork runs inside Claude Desktop. Add the hosted server as a custom connector — **Customize → Connectors → +** — and enter the URL with your key:\n\n```\nhttps://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE\n```\n\nFor a local setup, use the Claude Desktop config shown above.\n\n</details>\n\n<details>\n<summary>OpenWork</summary>\n\n[OpenWork](https://github.com/different-ai/openwork) is an open-source Cowork alternative with MCP support. Add AllNewsAPI using either the local command (`npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE`) or the hosted URL above, following OpenWork's MCP configuration.\n\n</details>\n\n**Any other MCP client:** point it at the hosted URL (`https://mcp.allnewsapi.com/mcp`) or run the `npx allnewsapi-mcp@latest` command with your API key.\n\n## Tools\n\n### `search-news`\nSearch articles by keyword, date, and filters.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `q` | string | Keywords to search for |\n| `startDate` / `endDate` | string | Date range (`YYYY-MM-DD`) |\n| `content` | boolean | Include full article content (default: false) |\n| `lang` | string | Language code(s), e.g. `en`, `fr` |\n| `country` | string | Country code(s), e.g. `us`, `gb` |\n| `region` | string | Region(s), e.g. `americas`, `europe` |\n| `category` | string | Category/categories, e.g. `business` |\n| `max` | number | Number of articles, 1–100 (default: 5) |\n| `page` | number | Page number (default: 1) |\n| `attributes` | string | Where to match keywords: `title`, `description`, `content` |\n| `sortby` | string | `publishedAt` or `relevance` |\n| `publisher` | string | Filter by publisher(s) |\n| `ai_sentiment` | string | `positive`, `negative`, or `neutral` |\n| `ai_entity_name` | string | Named entity, e.g. `Apple` |\n| `ai_entity_type` | string | Entity type, e.g. `person`, `organization`, `location` |\n\n### `headlines`\nGet top headlines, optionally filtered.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `country` | string | Country code(s), e.g. `us`, `gb` |\n| `category` | string | Category, e.g. `technology` |\n| `lang` | string | Language code, e.g. `en` |\n| `max` | number | Number of articles, 1–100 (default: 5) |\n| `ai_sentiment` | string | `positive`, `negative`, or `neutral` |\n| `ai_entity_name` | string | Named entity, e.g. `Apple` |\n| `ai_entity_type` | string | Entity type, e.g. `person`, `organization`, `location` |\n\n### `usage`\nCheck your plan, request limits, and remaining quota. No parameters.\n\n> **Plan note:** Advanced filters — `country`, `region`, `category`, `publisher`, `lang`, `attributes`, and `sortby` — require a paid plan. On the free plan, use `search-news` with `q` and `max`. See [pricing](https://allnewsapi.com/pricing).\n\n## AI filtering\n\n`search-news` and `headlines` accept AI-analyzed filters:\n\n- `ai_sentiment` — overall article sentiment (`positive`, `negative`, `neutral`)\n- `ai_entity_name` — a named entity in the article (e.g. `United Nations`)\n- `ai_entity_type` — entity category (`person`, `organization`, `location`)\n\nReturned articles may also include AI sentiment scores, detected entities, and a short AI summary when available.\n\n## Example prompts\n\n- \"Get me the latest technology news from the US\"\n- \"Find articles about climate change from European sources\"\n- \"Show me top business headlines from the past week\"\n- \"Find positive news about renewable energy\"\n- \"Show me articles mentioning Apple as an organization\"\n- \"Check my API usage and remaining quota\"\n\n## Supported values\n\nFull lists of accepted values live in the AllNewsAPI docs:\n\n- [Countries](https://allnewsapi.com/docs/api/countries)\n- [Languages](https://allnewsapi.com/docs/api/languages)\n- [Categories](https://allnewsapi.com/docs/api/categories)\n- [Regions](https://allnewsapi.com/docs/api/regions)\n\n## License\n\nMIT © [AllNewsAPI](https://allnewsapi.com) — see [LICENSE](LICENSE) for details.\n",
  "bytes": 7328,
  "sha": "7976e97133fccdccc38b241d0c584e3e87222db9f1ad7723c5e163d355c8b85b",
  "repo_slug": "allnewsapi/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_allnewsapi_mcp_server_e43ded23/readme"
}