Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@NewsData.io MCP Server What's the latest news about artificial intelligence?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP (Model Context Protocol) server that connects NewsData.io to Claude and other LLM clients. Search latest news, crypto news, market news, historical archives, and browse news sources — all from within your AI assistant.
Tool | Description |
| Latest news from the past 48 hours with full filtering |
| Cryptocurrency-specific news with coin filtering |
| Financial/stock market news (beta) with ticker symbols |
| Historical news search with date ranges (paid plans) |
| Browse available news sources by country/language/category |
All tools support: keyword search (AND/OR/NOT), country, language, category, domain, sentiment, pagination, and deduplication filters.
Related MCP server: mcp-newsdata
Node.js 18+ installed
NewsData.io API key — get one free at newsdata.io
cd newsdata-mcp-server
npm install
npm run buildexport NEWSDATA_API_KEY="your_api_key_here"Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"newsdata": {
"command": "node",
"args": ["/path/to/newsdata-mcp-server/dist/index.js"],
"env": {
"NEWSDATA_API_KEY": "your_api_key_here"
}
}
}
}Run as an HTTP server:
TRANSPORT=http PORT=3000 NEWSDATA_API_KEY="your_key" node dist/index.jsThe MCP endpoint will be available at http://localhost:3000/mcp
claude mcp add newsdata -- node /path/to/newsdata-mcp-server/dist/index.jsSet the env variable NEWSDATA_API_KEY in your shell before running.
Once connected, just ask Claude naturally:
"What's the latest news about AI?"
"Show me crypto news for Bitcoin and Ethereum"
"Find market news about AAPL and MSFT"
"Search for climate change news from US sources in the last 6 hours"
"List top English technology news sources"
"Find positive sentiment news about renewable energy"
Endpoint | Tool | Plan Required |
|
| Free+ |
|
| Basic+ |
|
| Basic+ |
|
| Professional+ |
|
| Free+ |
Variable | Required | Description |
| Yes | Your NewsData.io API key |
| No |
|
| No | HTTP port (default: 3000) |
MIT
Search historical news articles (paid plans only).
Access archived news with date range filtering. Useful for research and historical analysis.
Args:
q: Search keywords
from_date: Start date (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)
to_date: End date (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS)
country, language, category: Standard filters
size: Results per page
page: Pagination token
Examples:
News about Tesla in January 2025: q="tesla", from_date="2025-01-01", to_date="2025-01-31"
Historical crypto coverage: q="bitcoin", from_date="2024-01-01", to_date="2024-12-31"
Inputs: q, tag, page, size, +16 more.
Fetch cryptocurrency-specific news articles.
Dedicated endpoint for crypto/blockchain news with coin-specific filtering. Returns articles tagged with cryptocurrency topics from the past 48 hours.
Args:
q: Search keywords (e.g., 'bitcoin', 'ethereum defi')
coin: Filter by specific coin (e.g., 'BTC,ETH,SOL')
country, language, category: Standard filters
sentiment: Filter by sentiment
timeframe: Lookback in hours (1-48) or minutes
size: Results per page
page: Pagination token
Examples:
Bitcoin news: q="bitcoin" or coin="BTC"
DeFi news in English: q="defi", language="en"
Negative crypto sentiment: sentiment="negative"
Inputs: q, tag, coin, page, +16 more.
Fetch the latest news articles from the past 48 hours worldwide.
Supports keyword search, country/language/category filtering, sentiment analysis, and pagination. Returns up to 50 articles per request (10 for free plans).
Args:
q: Search keywords (supports AND/OR/NOT operators)
qInTitle: Search in titles only
country: Filter by country codes (e.g., 'us,gb')
category: Filter by category (e.g., 'business,technology')
language: Filter by language (e.g., 'en')
sentiment: Filter by sentiment (positive/negative/neutral)
timeframe: Lookback in hours (1-48) or minutes (e.g., '120m')
size: Results per page (1-50)
page: Pagination token from previous response
Examples:
Latest US tech news: q="technology", country="us"
Breaking news last 2 hours: timeframe=2
Positive AI news: q="artificial intelligence", sentiment="positive"
Inputs: q, tag, page, size, +15 more.
Fetch financial and stock market news (beta endpoint).
Get real-time market news including stock analysis, financial sentiment, and business mergers. Returns articles from the past 48 hours.
Args:
q: Search keywords (e.g., 'AAPL', 'stock market')
symbol: Stock ticker symbols (e.g., 'AAPL,MSFT,GOOGL')
country, language: Standard filters
sentiment: Filter by financial sentiment
timeframe: Lookback in hours (1-48) or minutes
size: Results per page
page: Pagination token
Examples:
Apple stock news: symbol="AAPL"
Market crash coverage: q="market crash", sentiment="negative"
Tech earnings: q="earnings report", category="business"
Inputs: q, page, size, image, +15 more.
List available news sources with filtering options.
Browse and discover news sources indexed by NewsData.io, filtered by country, language, or category.
Args:
country: Filter sources by country code (e.g., 'us')
language: Filter sources by language (e.g., 'en')
category: Filter sources by category (e.g., 'technology')
prioritydomain: Filter by source priority tier
domainurl: Search for specific domain
Examples:
English tech sources: language="en", category="technology"
US news sources: country="us"
Top-tier sources: prioritydomain="top"
Inputs: country, category, language, domainurl, +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
Each tool targets a distinct news domain or time range: latest (general recent), crypto, archive (historical), market (financial), and sources (directory). Descriptions clearly differentiate them, and filters are tailored to each use case.
All tool names follow the consistent `newsdata_<resource>` pattern, making the set predictable and easy to navigate. No mixed conventions or vague verbs.
Five tools is well-scoped for a news API, covering the core functionalities of fetching recent, specialized, and historical news, plus source discovery. It is neither thin nor bloated.
The set covers the primary news retrieval workflows (latest, crypto, market, archive) and source browsing. Minor gaps exist, such as a dedicated article-by-ID lookup or trending topics, but these do not significantly impede typical use cases.
Get access to real-time and historical news data including top headlines from global sources
Give your AI assistant access to the world’s news. Search articles in any language, track coverage over time, and research companies and events.
NewsData.io MCP — wraps the NewsData.io global news API (newsdata.io)
Search global news in natural language. Filter by language, country, date, sentiment, and domain.
