market-pulse-mcp

<div align="center">

<img src="https://capsule-render.vercel.app/api?type=venom&color=0:0d1117,50:1a3a2a,100:6ee7b7&height=200&section=header&text=MARKET%20PULSE&fontSize=70&fontColor=ffffff&animation=twinkling&stroke=6ee7b7&strokeWidth=1" width="100%" />

<br />

<h3>Give Claude eyes on the market.</h3>

<p> <a href="https://github.com/decksaga/market-pulse-mcp/stargazers"><img src="https://img.shields.io/github/stars/decksaga/market-pulse-mcp?style=for-the-badge&color=6ee7b7&labelColor=0d1117" /></a> <a href="https://github.com/decksaga/market-pulse-mcp/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge&labelColor=0d1117" /></a> <img src="https://img.shields.io/badge/MCP-Compatible-6ee7b7?style=for-the-badge&labelColor=0d1117" /> <img src="https://img.shields.io/badge/API_Keys-None-ff6b6b?style=for-the-badge&labelColor=0d1117" /> <img src="https://img.shields.io/badge/Cost-$0-6ee7b7?style=for-the-badge&labelColor=0d1117" /> <img src="https://img.shields.io/badge/v2.0-New-blueviolet?style=for-the-badge&labelColor=0d1117" /> </p>

</div>

<br />

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.

<br />

🛠️ 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 |

<br />

🚀 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.

<br />

📡 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 |

<br />

📁 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

<br />

License

MIT — do whatever you want with it.

<br />

<div align="center">

Made by @decksaga

<img src="https://capsule-render.vercel.app/api?type=waving&color=0:0d1117,50:1a3a2a,100:6ee7b7&height=100&section=footer" width="100%" />

</div>