data-aggregator-mcp

Data Aggregator MCP Server

A unified MCP (Model Context Protocol) server that replaces 5-10 separate data servers with one installation. Instead of juggling separate servers for financial data, weather, news, web scraping, and more, install one server that handles all your data needs.

Solves "MCP server sprawl."

Pricing

Plan	Price
Free	$0	100 queries/day, no credit card — just run it
Pro	$16/mo	Buy →
Premium	$32/mo	Buy →

License keys are emailed instantly after checkout. Activate via the LICENSE_KEY environment variable. More info: aivp-mcp.vercel.app

Quick Start

Install and run with npx

npx -y data-aggregator-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "data-aggregator": {
      "command": "npx",
      "args": ["-y", "data-aggregator-mcp"],
      "env": {
        "NEWS_API_KEY": "your-optional-newsapi-key",
        "ALPHA_VANTAGE_KEY": "your-optional-alpha-vantage-key",
        "LICENSE_KEY": "<your license key — omit for free tier>"
      }
    }
  }
}

HTTP/SSE Transport (Remote Deployment)

# Start with HTTP transport on port 3000 (default)
npx -y data-aggregator-mcp --sse

# Or specify a custom port
npx -y data-aggregator-mcp --sse --port=8080

Tools

1. query_stocks - Market Data

Fetch real-time stock and cryptocurrency prices.

Sources: Yahoo Finance (stocks), CoinGecko (crypto) -- both free, no API key required. Optional Alpha Vantage support with ALPHA_VANTAGE_KEY env variable.

Parameter	Type	Required	Description
symbol	string	Yes	Ticker symbol (e.g., AAPL, BTC, ETH)
type	"stock" | "crypto" | "auto"	No	Asset type detection (default: auto)

Example requests:

"Get me the current price of AAPL"
"What's Bitcoin trading at?"
"Fetch SOL crypto price"

Example response:

{
  "symbol": "AAPL",
  "price": 198.52,
  "currency": "USD",
  "change": 2.34,
  "changePercent": 1.19,
  "volume": 54321000,
  "high": 199.10,
  "low": 196.80,
  "source": "Yahoo Finance"
}

2. fetch_webpage - Web Scraping

Extract structured data from any web page.

Parameter	Type	Required	Description
url	string (URL)	Yes	Page to scrape
selector	string	No	CSS selector (#id, .class, or tag name)

Example requests:

"Scrape the main content from https://example.com"
"Get the article text from this URL using selector .post-content"

Returns: Title, meta description, headings, main content (text only), and links.

3. search_news - News Aggregation

Search and aggregate news from multiple sources.

Sources: Google News RSS (free, no key) or NewsAPI.org (optional key via NEWS_API_KEY env).

Parameter	Type	Required	Description
query	string	No	Search keyword
category	string	No	business, technology, science, etc. (NewsAPI only)
source	string	No	Source ID (e.g., bbc-news)
language	string	No	Language code (default: en)
from	string	No	Start date YYYY-MM-DD (NewsAPI only)
to	string	No	End date YYYY-MM-DD (NewsAPI only)
maxResults	number	No	1-100 (default: 10)

Example requests:

"Search news about artificial intelligence"
"Get top technology news"
"Find news about climate change from the last week"

4. query_weather - Weather Data

Current conditions and 7-day forecasts.

Source: Open-Meteo API (100% free, no API key required).

Parameter	Type	Required	Description
city	string	No*	City name (e.g., "London")
latitude	number	No*	Latitude (-90 to 90)
longitude	number	No*	Longitude (-180 to 180)
units	"celsius" | "fahrenheit"	No	Temperature units (default: celsius)

*Provide either city or both latitude/longitude.

Example requests:

"What's the weather in Tokyo?"
"Get the 7-day forecast for New York in Fahrenheit"
"Weather at coordinates 51.5, -0.1"

Example response:

{
  "location": "London, England, United Kingdom",
  "current": {
    "temperature": 15.2,
    "feelsLike": 13.8,
    "humidity": 72,
    "windSpeed": 12.5,
    "weatherDescription": "Partly cloudy"
  },
  "forecast": [
    {
      "date": "2026-03-31",
      "temperatureMax": 17.1,
      "temperatureMin": 8.3,
      "precipitationProbability": 20,
      "weatherDescription": "Mainly clear"
    }
  ]
}

5. query_exchange_rates - Currency Exchange

Real-time and historical exchange rates with conversion.

Sources: Frankfurter/ECB (fiat, free), CoinGecko (crypto, free).

Parameter	Type	Required	Description
base	string	Yes	Base currency (USD, EUR, BTC, etc.)
target	string	Yes	Target currency
amount	number	No	Amount to convert (default: 1)
date	string	No	Historical date YYYY-MM-DD (fiat only)

Supported flows: Fiat-to-fiat, fiat-to-crypto, crypto-to-fiat, crypto-to-crypto.

Example requests:

"Convert 100 USD to EUR"
"What's the BTC to USD rate?"
"Historical EUR/GBP rate on 2025-01-15"

6. query_public_data - Multi-Purpose API

Access various public data APIs through sub-commands.

Parameter	Type	Required	Description
command	string	Yes	Sub-command (see below)

Sub-commands:

wikipedia - Article Summaries

Parameter	Description
query	Search term (e.g., "Theory of relativity")
language	Wiki language code (default: en)

ip_geolocation - IP Location Lookup

Parameter	Description
ip	IP address (omit for your own IP)

dns_lookup - DNS Records

Parameter	Description
domain	Domain name (e.g., "example.com")
recordType	A, AAAA, MX, TXT, NS, CNAME, SOA (default: A)

expand_url - URL Expander

Parameter	Description
url	Shortened URL to follow to its destination

Example requests:

"Look up the Wikipedia article on quantum computing"
"What's the geolocation of IP 8.8.8.8?"
"Get MX records for gmail.com"
"Expand this shortened URL: https://bit.ly/xyz"

Environment Variables

Variable	Required	Description
NEWS_API_KEY	No	NewsAPI.org key for enhanced news search. Falls back to Google News RSS without it.
ALPHA_VANTAGE_KEY	No	Alpha Vantage key for stock data fallback. Yahoo Finance is used by default.

Architecture

Caching

Built-in in-memory cache with per-category TTLs:

Data Type	Cache Duration
Market data (stocks/crypto)	5 minutes
Exchange rates	30 minutes
News articles	15 minutes
Weather	1 hour
Web scraping	10 minutes
Public data (Wikipedia, DNS, etc.)	1 hour

Rate Limiting

Per-source sliding-window rate limiters prevent API abuse:

Source	Limit
CoinGecko	30 req/min
Open-Meteo	60 req/min
Frankfurter (exchange)	60 req/min
NewsAPI	50 req/min
Google News RSS	60 req/min
Wikipedia	100 req/min
Generic HTTP	120 req/min

Error Handling

• Automatic retries with exponential back-off (up to 3 attempts)
• Graceful degradation when APIs are unavailable
• User-friendly error messages
• Fallback sources (Yahoo Finance -> Alpha Vantage, NewsAPI -> Google News RSS)

Pricing

Free Tier

• 100 queries/day across all tools
• No credit card required
• All 6 tools included

Pay-Per-Query

• $0.01 - $0.05 per query depending on data source
• No monthly commitment
• Volume discounts available

Pro Plan - $16/month

• Unlimited queries
• Priority rate limits
• Email support
• Via MCPize

Premium Plan - $32/month

• Everything in Pro
• Dedicated rate limit pools
• Custom API key management
• Priority support
• Historical data access
• Via MCPize

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode for development
npm run dev

# Run the server (stdio)
npm start

# Run the server (HTTP/SSE)
npm run start:sse

License

MIT