Financeos Mcp

@arjunsena-git

2 months ago

Real-time financial superpowers for Claude. Get live crypto prices (Bitcoin, Ethereum, Bittensor/TAO), stock quotes for US and Indian NSE stocks, full portfolio P&L, Fear & Greed index, top movers and global market overview. 8 tools. Zero API keys needed. Completely free to install.

Overview Tools Comments

Overview

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

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

💰 Pricing (Pro Version)

Plan	Price	Features
Free	$0	3 tools, 50 calls/day
Pro	$19/mo	All 7 tools, unlimited calls
Team	$49/mo	Multi-user, webhooks, priority support

Get Pro: [your-gumroad-link-here]

🗺️ 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:

CoinGecko — crypto prices
Yahoo Finance — stock quotes
Alternative.me — fear & greed index

📄 License

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

Built with ❤️ using the Model Context Protocol SDK

Try in Playground

Server Config

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

Build with ShipAny.