decksaga/market-pulse-mcp
📇 ☁️ - Live market data for AI agents — crypto prices, stocks (any ticker), S&P 500/NASDAQ/Dow indices, forex (150+ pairs), trending coins, and Fear & Greed Index. 8 tools, zero API keys, zero cost. Uses CoinGecko, Yahoo Finance, and ExchangeRate API.
Quick Install
{
"mcpServers": {
"decksaga-market-pulse-mcp": {
"command": "npx",
"args": [
"-y",
"decksaga-market-pulse-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
Give Claude eyes on the market.
What is this?
An MCP server that gives Claude live market data instead of guessing or searching the web. Crypto, stocks, forex, indices, sentiment — real numbers from real APIs.
You: "how's the market doing?"
📊 MARKET SUMMARY
═══════════════════
🪙 Top Cryptos:
Bitcoin (BTC): $78,004.00 🔴 -0.24%
Ethereum (ETH): $2,489.00 🟢 +1.12%
BNB (BNB): $598.00 🟢 +0.87%
Solana (SOL): $148.30 🔴 -2.31%
XRP (XRP): $0.52 🟢 +0.45%
📈 Indices:
S&P 500: 5,842.01 🟢 +0.62%
NASDAQ: 18,847.28 🟢 +0.89%
Dow Jones: 42,654.74 🔴 -0.12%
💱 Forex (USD base):
USD/EUR: 0.9234
USD/GBP: 0.7891
USD/JPY: 154.23
😰 Fear & Greed: 38/100 (Fear)
No web searches. No hallucinated data. Just live numbers.
🛠️ 8 Tools
| Tool | Does what | |
|---|---|---|
| 🪙 | get_price | Price of any crypto — BTC, ETH, SOL, DOGE, and 10+ more |
| 📊 | get_top_cryptos | Top N ranked by market cap |
| 📈 | get_stock_price | NEW — Any stock or ETF: AAPL, NVDA, TSLA, MSFT, SPY, QQQ... |
| 🏛️ | get_market_indices | NEW — S&P 500, NASDAQ, Dow Jones, Russell 2000, VIX |
| 🔥 | get_trending_cryptos | NEW — Top 7 trending coins on CoinGecko right now |
| 💱 | get_forex_rate | Exchange rate between any two currencies |
| 😱 | get_fear_greed_index | Fear & Greed Index + 7-day trend |
| 📋 | get_market_summary | Everything above in one call |
🚀 Setup (2 minutes)
1. Clone and install:
git clone https://github.com/decksaga/market-pulse-mcp.git
cd market-pulse-mcp
npm install
2. Add to your Claude config:
{
"mcpServers": {
"market-pulse": {
"command": "node",
"args": ["/path/to/market-pulse-mcp/dist/server.js"]
}
}
}
3. Restart Claude. Ask it anything about the market.
Already compiled. No build step.
📡 Free APIs, No Keys
| Source | What it provides |
|---|---|
| CoinGecko | Crypto prices, market caps, trending, 24h volume |
| Yahoo Finance | Stocks, ETFs, market indices |
| ExchangeRate API | 150+ fiat currency pairs |
| Alternative.me | Crypto Fear & Greed Index |
📁 Structure
market-pulse-mcp/
├── src/
│ ├── server.ts # Tool definitions (8 tools)
│ └── apis.ts # CoinGecko, Yahoo Finance, ExchangeRate, Alternative.me
├── dist/ # Ready to run
├── package.json
└── tsconfig.json
License
MIT — do whatever you want with it.
Made by @decksaga