Skip to main content
Glama
FinanceOS MCP

FinanceOS MCP

financeos-mcp MCP server

💰 FinanceOS MCP...

FinanceOS MCP 💰

Real-time finance & crypto superpowers for Claude. Built for investors, by an investor.

Give Claude live access to crypto prices, stock quotes, portfolio P&L, risk analysis, Bittensor stats, and market sentiment — all in natural language.


🛠️ Tools Included

Tool

What it does

get_crypto_price

Live price, 24h/7d change, market cap for any crypto

get_portfolio_summary

Real-time P&L across your crypto holdings

get_stock_quote

NSE, BSE & global stock prices (Yahoo Finance)

get_fear_greed_index

Crypto market sentiment (0–100 scale)

get_bittensor_stats

TAO price, network data, staking APY overview

get_top_movers

Top gainers & losers in the last 24h

analyze_portfolio_risk

Diversification score, concentration risk, suggestions


Related MCP server: Market Pulse MCP

⚡ Quick Setup (5 minutes)

Step 1 — Install

git clone https://github.com/YOUR_USERNAME/financeos-mcp
cd financeos-mcp
npm install
npm run build

Step 2 — Add to Claude Desktop

Open your Claude Desktop config file:

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this (replace the path with your actual path):

{
  "mcpServers": {
    "financeos": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/financeos-mcp/build/index.js"]
    }
  }
}

Step 3 — Restart Claude Desktop

Quit and reopen Claude Desktop. You should see a 🔨 hammer icon in the chat box. Click it — you'll see all 7 FinanceOS tools listed.

Step 4 — Try it out

Ask Claude any of these:

  • "What's the current Bitcoin price and sentiment?"

  • "Analyse my portfolio: bitcoin:0.5, ethereum:2, solana:10"

  • "How is RELIANCE.NS doing today?"

  • "Show me top 5 crypto gainers right now"

  • "Give me a full Bittensor overview"


💬 Example Prompts

"How is my portfolio doing? I hold 0.5 BTC, 2 ETH, and 15 SOL.
 I bought BTC at $45000, ETH at $2000, SOL at $120."

"What's the market sentiment today? Should I be buying or waiting?"

"Analyse the risk of this portfolio: 
 bitcoin:20000, ethereum:8000, INFY.NS:5000, gold:3000, reliance:4000"

"Give me a complete Bittensor briefing — price, network, staking."

🔧 Test Without Claude

Use the MCP Inspector to test all tools in a browser UI:

npx @modelcontextprotocol/inspector node build/index.js

Open the URL shown → Connect → click any tool → Run.


🚀 Pro Version

Want FinanceOS without any installation? No Node.js, no config files, ready in 60 seconds.

FinanceOS MCP Pro — $19/month →

  • ✅ No installation required

  • ✅ Higher rate limits

  • ✅ 1 week free trial

  • ✅ Priority support

  • ✅ Early access to v2 tools (coming soon)

Free version always available here on GitHub.


🗺️ Roadmap

  • Dividend calendar for stocks

  • DeFi yield tracker (Aave, Compound)

  • Indian mutual fund NAV lookup

  • REIT yield comparator

  • P2P lending portfolio tracker

  • Bittensor subnet miner rankings


📋 Data Sources

All free, no API keys required:


📄 License

MIT — free to use, modify, and sell integrations.


Built with ❤️ using the Model Context Protocol SDK

Available Tools

8 tools
get_bittensor_statsA

Get live Bittensor (TAO) price, network stats and a breakdown of passive income options including staking yield.

Inputs: no named parameters.

get_crypto_priceA

Get live crypto price, 24h/7d change, market cap, volume and ATH. Supports Bitcoin, Ethereum, TAO (Bittensor) and 10,000+ coins via CoinGecko ID.

Inputs: coin_id (required), currency.

get_fear_greed_indexA

Get the Crypto Fear & Greed Index (0=Extreme Fear, 100=Extreme Greed) with 7-day history and investment interpretation.

Inputs: no named parameters.

get_global_crypto_marketA

Get global crypto market overview: total market cap, BTC dominance, 24h volume and active coin count.

Inputs: no named parameters.

get_multiple_crypto_pricesB

Get live prices for multiple cryptocurrencies at once. Perfect for a portfolio snapshot.

Inputs: coin_ids (required), currency.

get_portfolio_summaryB

Calculate real-time P&L for a portfolio of crypto and/or stocks. Returns per-asset breakdown and total portfolio performance.

Inputs: holdings (required).

get_stock_quoteC

Get a real-time stock quote. US stocks: AAPL, TSLA. Indian NSE stocks: RELIANCE.NS, TCS.NS, INFY.NS

Inputs: symbol (required).

get_top_moversB

Get top gaining and losing cryptocurrencies in the last 24h from the top 100 by market cap.

Inputs: limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 8 tools

    Disambiguation4/5

    Each tool targets a distinct data need: sentiment, specific asset stats, single/multiple prices, stock quote, portfolio, movers, and global market. The only mild ambiguity is get_bittensor_stats vs get_crypto_price for TAO, but the descriptions clarify the network/staking focus.

    Naming Consistency5/5

    Every tool follows the same get_<object> snake_case pattern, making the set predictable. Plural/singular variations are semantically meaningful rather than inconsistent.

    Tool Count5/5

    Eight tools is a well-scoped size for a market-data and portfolio server. Each endpoint covers a distinct high-level use case without redundancy or bloat.

    Completeness3/5

    The core read-only surface covers pricing, portfolio P&L, and market overview well, but there are notable gaps: no historical price data, no symbol/CoinGecko ID search, and no stock-specific movers despite stock support. These gaps would prevent common finance queries.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides AI agents with real-time financial market intelligence including stock quotes, crypto data, technical analysis, and portfolio insights. Enables natural language queries for current prices, technical indicators, asset comparisons, and portfolio analysis.
      17
      9
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables Claude to access real-time crypto prices, forex rates, and market sentiment data through free public APIs with no keys required.
      5
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides real-time stock quotes, market indices, historical data, and financial visualizations from Yahoo Finance without API keys, enabling users to analyze and visualize market data through Claude.
      3
      9 npm
      1
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Provides 32 trading analysis tools for AI-powered market analysis, including real-time data, technical indicators, options Greeks, scanners, and Interactive Brokers portfolio management, all accessible via natural language in Claude Desktop.
      36
      406
      MIT