decksaga/market-pulse-mcp

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.