Skip to main content
Glama
AllNewsAPI MCP

AllNewsAPI MCP

Official

AllNewsAPI MCP

npm Listed on mcpservers.org AllNewsAPI/mcp-server MCP server

AllNewsAPI/mcp-server MCP server

Get access to real-time and historical news data including top headlines from global sources via AllNewsAPI. Supports multiple filter options including keyword search, category, language and more. This Model Context Protocol server lets MCP clients (Claude, Cursor, VS Code, Windsurf, and others) search news articles, fetch top headlines, and check your API usage.

You'll need an API key — get one at allnewsapi.com.

Quick start

Pick one of the two ways to connect.

Hosted (no install)

Point your client at the hosted server and pass your API key in the X-API-Key header:

{
  "mcpServers": {
    "allnewsapi": {
      "type": "remote",
      "url": "https://mcp.allnewsapi.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Prefer a URL-only setup? Use https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE instead of the header.

The 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).

Local (npx)

Runs the server on your machine via npx — no clone or build needed:

{
  "mcpServers": {
    "allnewsapi": {
      "command": "npx",
      "args": ["allnewsapi-mcp@latest", "--apikey", "YOUR_API_KEY_HERE"]
    }
  }
}

You can also supply the key as an ALLNEWSAPI_KEY environment variable instead of --apikey.

Client-specific setup

Edit your config (Settings → Developer → Edit Config) and add the local or hosted snippet above. Full guide: modelcontextprotocol.io/quickstart/user.

Cursor Settings → MCP → Add new MCP Server. Name it "AllNewsAPI", choose the command type, and enter:

npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE
code --add-mcp '{"name":"allnewsapi","command":"npx","args":["allnewsapi-mcp@latest","--apikey","YOUR_API_KEY_HERE"]}'

The server is then available to your GitHub Copilot agent. Full guide: VS Code MCP docs.

Add the local or hosted snippet above to your MCP config. Full guide: Windsurf MCP docs.

Add it from the terminal — local:

claude mcp add allnewsapi -- npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE

Or the hosted server:

claude mcp add --transport http allnewsapi https://mcp.allnewsapi.com/mcp --header "X-API-Key: YOUR_API_KEY_HERE"

Cowork runs inside Claude Desktop. Add the hosted server as a custom connector — Customize → Connectors → + — and enter the URL with your key:

https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE

For a local setup, use the Claude Desktop config shown above.

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.

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.

Related MCP server: mcp-newsapi

Tools

search-news

Search articles by keyword, date, and filters.

Parameter

Type

Description

q

string

Keywords to search for

startDate / endDate

string

Date range (YYYY-MM-DD)

content

boolean

Include full article content (default: false)

lang

string

Language code(s), e.g. en, fr

country

string

Country code(s), e.g. us, gb

region

string

Region(s), e.g. americas, europe

category

string

Category/categories, e.g. business

max

number

Number of articles, 1–100 (default: 5)

page

number

Page number (default: 1)

attributes

string

Where to match keywords: title, description, content

sortby

string

publishedAt or relevance

publisher

string

Filter by publisher(s)

ai_sentiment

string

positive, negative, or neutral

ai_entity_name

string

Named entity, e.g. Apple

ai_entity_type

string

Entity type, e.g. person, organization, location

headlines

Get top headlines, optionally filtered.

Parameter

Type

Description

country

string

Country code(s), e.g. us, gb

category

string

Category, e.g. technology

lang

string

Language code, e.g. en

max

number

Number of articles, 1–100 (default: 5)

ai_sentiment

string

positive, negative, or neutral

ai_entity_name

string

Named entity, e.g. Apple

ai_entity_type

string

Entity type, e.g. person, organization, location

usage

Check your plan, request limits, and remaining quota. No parameters.

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.

AI filtering

search-news and headlines accept AI-analyzed filters:

  • ai_sentiment — overall article sentiment (positive, negative, neutral)

  • ai_entity_name — a named entity in the article (e.g. United Nations)

  • ai_entity_type — entity category (person, organization, location)

Returned articles may also include AI sentiment scores, detected entities, and a short AI summary when available.

Example prompts

  • "Get me the latest technology news from the US"

  • "Find articles about climate change from European sources"

  • "Show me top business headlines from the past week"

  • "Find positive news about renewable energy"

  • "Show me articles mentioning Apple as an organization"

  • "Check my API usage and remaining quota"

Supported values

Full lists of accepted values live in the AllNewsAPI docs:

License

MIT © AllNewsAPI — see LICENSE for details.

Available Tools

3 tools
headlinesGet HeadlinesB
Read-only
Inspect

Get top headlines with optional filtering by country, category, and language

Inputs: max, lang, country, category, +3 more.

search-newsSearch NewsB
Read-only
Inspect

Search for news articles using various parameters including keywords, date ranges, and filters

Inputs: q, max, lang, page, +12 more.

usageAPI UsageA
Read-only
Inspect

Check your current API plan, usage limits, and remaining quota

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 3 tools

    Disambiguation4/5

    search-news and headlines are clearly distinct in purpose—one returns filtered article search results, the other returns top headlines by source/category. usage is completely separate, so there is little risk of selecting the wrong tool.

    Naming Consistency3/5

    Tool names are readable but follow mixed conventions: search-news uses a verb-noun pattern, while headlines and usage are bare nouns. This is not chaotic, but the naming style is inconsistent across the set.

    Tool Count4/5

    Three tools is a reasonable minimal set for a news API server covering search, headlines, and account usage. It is slightly thin but appropriate for the apparent scope.

    Completeness3/5

    The core news retrieval operations are covered, and usage is a nice operational addition. However, a typical news API also exposes available sources or categories, and that capability is missing, leaving a notable gap for agents that need source metadata.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to search news articles, get top headlines, and browse sources via the NewsAPI.org service.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables fetching top headlines and searching news archives from NewsAPI.org, allowing AI agents to access current and historical news data.
      110 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables news search and headline retrieval using NewsAPI. Supports getting top headlines by country and category, and searching articles across thousands of sources.
      2
      MIT