Claude Desktop

\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

\n\n

Cursor

\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

\n\n

VS Code

\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

\n\n

Windsurf

\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

\n\n

Claude Code

\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

\n\n

Claude Cowork

\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

\n\n

OpenWork

\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

\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](https://github.com/AllNewsAPI/mcp-server/blob/main/LICENSE) for details.\n","changelogMarkdown","videoKey","requiredSecretsJson","[{\"name\":\"X-API-Key\",\"scope\":\"per-user\",\"header\":\"X-API-Key\"}]","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_106":107,"_108":109,"_110":111,"_112":113,"_114":115,"_116":117},"requiredSecrets",[100],"tags",[],"assets",[],"stats",{"_98":85,"_99":85},"ratingAvg","reviewCount",{"_101":102,"_103":104,"_105":102},"name","X-API-Key","scope","per-user","header","topics",[],"license","MIT","language","TypeScript","registryName","io.github.AllNewsAPI/mcp-server","homepage","https://allnewsapi.com","packages",[118],{"_119":120,"_121":122,"_74":75},"registryType","npm","identifier","allnewsapi-mcp","ENV",{"_125":126,"_127":128,"_129":130},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]