🌊 Mizu Finance MCP Server

High-performance, async Model Context Protocol server for financial intelligence. Built with @modelcontextprotocol/sdk · Node.js (TypeScript)

What is Mizu?

Mizu gives AI agents real-time, institutional-grade financial intelligence through a modular suite of tools. It is designed to bridge the gap between LLMs and live market data.

🛠️ The Mizu Toolbox (Categories)

1. General Tools (Intelligence & Search)

• mizu_web_search: Search general web knowledge (Brave/Tavily).
• mizu_macro_scan: Scan trusted sources for global economic and geopolitical context.
• mizu_index: Scrape any URL into LLM-ready markdown.
• mizu_research: Conduct deep-dive Chain-of-Thought financial research.

2. Essential Niche (Deep Financial Data)

• mizu_financials: Fetch standardized Income Statement, Balance Sheet, and Cash Flow.
• mizu_insider_tracker: Track CEO and insider buying/selling in real-time.
• mizu_earnings_xray: Extract and read live Earnings Call Transcripts.
• mizu_sec_reader: Fetch SEC filings and intelligently scrape data.
• mizu_market_pulse: Explains sudden price action or news catalysts.
• mizu_asset_screen: Query market with quantitative filters (Market Cap, PE, etc).

3. Limited Time (LT) Hackathon Tools (Gen Z Gamification)

• mizu_roast_my_spending_lt: Brutal math roast of teenage spending vs compound interest.
• mizu_freelance_split_lt: 50/30/20 split for freelance income with affiliate integration.
• mizu_first_investment_lt: Path for buying the first real asset (VOO) vs gambling.
• mizu_explain_finance_lt: Financial concepts explained via Video Game analogies.

🚀 Quick Start

Step 1 — Installation

To use the global mizu command anywhere:

npm install -g mizu-kage

Or just run it instantly via npx:

npx -y mizu-kage@latest

Step 2 — Get your API keys

| Service | Get Key | Free Tier | |---|---|---| | Brave Search | brave.com/search/api | 2,000 queries/month | | FMP | financialmodelingprep.com | 250 requests/day | | Firecrawl | firecrawl.dev | 500 credits/month |

Add these to your .env or system environment variables.

💻 Connect to Claude Desktop

Open your Claude Desktop config file: ~/Library/Application Support/Claude/claude_desktop_config.json

Add Mizu:

{
  "mcpServers": {
    "mizu": {
      "command": "npx",
      "args": ["-y", "mizu-kage@latest"],
      "env": {
        "FMP_API_KEY": "YOUR_KEY",
        "TAVILY_API_KEY": "YOUR_KEY",
        "FIRECRAWL_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Restart Claude Desktop — you'll see the Mizu 🌊 tools appear.

Project Structure

mizu/
├── src/
│   └── index.ts           # Main MCP server
├── package.json           # Node.js dependencies & scripts
├── tsconfig.json          # TypeScript builder config
└── README.md              # This file

Created by Kalmukhan Amirlan