Multi-Tool Servers — Building a Real Platform

// Layer 1: Data fetching (primitive tools)
server.tool("get_quote", "Get stock price", ...);
server.tool("get_financials", "Get financial statements", ...);
server.tool("get_news", "Get recent news", ...);

// Layer 2: Analysis (uses Layer 1 data internally)
server.tool(
  "analyze_stock",
  "Complete stock analysis combining price, fundamentals, and news",
  { symbol: z.string() },
  async ({ symbol }) => {
    // Internally calls the same APIs as Layer 1 tools
    const [quote, financials, news] = await Promise.all([
      fetchQuote(symbol),
      fetchFinancials(symbol),
      fetchNews(symbol)
    ]);

    return { content: [{ type: "text", text: JSON.stringify({
      quote, financials, news,
      // Pre-computed insights the AI can use directly
      signals: {
        pe_vs_sector: quote.pe / financials.sector_avg_pe,
        revenue_growth: financials.revenue_yoy_pct,
        sentiment: news.filter(n => n.sentiment > 0).length / news.length
      }
    }, null, 2) }] };
  }
);

// Layer 3: Workflow (orchestrates multiple analyses)
server.tool(
  "compare_stocks",
  "Compare 2-5 stocks side by side on key metrics",
  {
    symbols: z.array(z.string()).min(2).max(5)
      .describe("List of stock tickers to compare")
  },
  async ({ symbols }) => {
    const analyses = await Promise.all(
      symbols.map(s => analyzeStock(s))
    );
    return { content: [{ type: "text",
      text: JSON.stringify({ comparison: analyses }, null, 2)
    }] };
  }
);

// Validate required env vars at startup — fail fast
const REQUIRED_KEYS = ["ALPHA_VANTAGE_KEY", "FINNHUB_KEY"];
const missing = REQUIRED_KEYS.filter(k => !process.env[k]);

if (missing.length > 0) {
  console.error(`Missing required env vars: ${missing.join(", ")}`);
  console.error("Set them in .mcp.json under \"env\" or export them.");
  process.exit(1);
}

{
  "name": "@yourorg/finance-mcp-server",
  "version": "1.0.0",
  "description": "MCP server for financial data — stocks, crypto, news",
  "type": "module",
  "bin": {
    "finance-mcp": "./index.js"
  },
  "keywords": ["mcp", "mcp-server", "finance", "stocks", "claude"],
  "files": ["index.js", "lib/", "tools/", "resources/"],
  "engines": { "node": ">=18" },
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.12.0",
    "zod": "^3.23.0"
  }
}

# Publish to npm
npm publish --access public

# Users run with npx (no install needed)
npx @yourorg/finance-mcp-server

# Or in .mcp.json
{
  "mcpServers": {
    "finance": {
      "command": "npx",
      "args": ["@yourorg/finance-mcp-server"],
      "env": { "ALPHA_VANTAGE_KEY": "..." }
    }
  }
}

{
  "mcpServers": {
    "finance": {
      "command": "npx",
      "args": ["@yourorg/finance-mcp-server"],
      "env": { "ALPHA_VANTAGE_KEY": "${ALPHA_VANTAGE_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "finance": {
      "command": "npx",
      "args": ["@yourorg/finance-mcp-server"],
      "env": { "ALPHA_VANTAGE_KEY": "${ALPHA_VANTAGE_KEY}" }
    }
  }
}

{
  "servers": {
    "finance": {
      "type": "stdio",
      "command": "npx",
      "args": ["@yourorg/finance-mcp-server"],
      "env": { "ALPHA_VANTAGE_KEY": "${ALPHA_VANTAGE_KEY}" }
    }
  }
}

#!/bin/bash
# Auto-setup MCP config for all supported IDEs

CONFIG='{
  "mcpServers": {
    "finance": {
      "command": "npx",
      "args": ["@yourorg/finance-mcp-server"],
      "env": { "ALPHA_VANTAGE_KEY": "'$ALPHA_VANTAGE_KEY'" }
    }
  }
}'

# Claude Code
echo "$CONFIG" > .mcp.json

# Cursor
mkdir -p .cursor && echo "$CONFIG" > .cursor/mcp.json

# Windsurf
mkdir -p .windsurf && echo "$CONFIG" > .windsurf/mcp.json

# VS Code
mkdir -p .vscode && echo "$CONFIG" > .vscode/mcp.json

echo "MCP configured for Claude Code, Cursor, Windsurf, and VS Code!"

#!/usr/bin/env node
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
import { TTLCache } from "./lib/cache.js";
import { fetchAPI, safeTool } from "./lib/utils.js";

const cache = new TTLCache();
const server = new McpServer({
  name: "finance-platform",
  version: "2.0.0",
  description: "Financial data platform — stocks, crypto, news, earnings, screener"
});

// ─── Tool 1: Stock Quote ────────────────────────────────────
server.tool("get_stock_quote", "Get real-time stock price and key metrics",
  { symbol: z.string().describe("Ticker (AAPL, MSFT)") },
  safeTool(async ({ symbol }) => { /* ... */ })
);

// ─── Tool 2: Crypto Price ───────────────────────────────────
server.tool("get_crypto_price", "Get cryptocurrency price and market data",
  { coin: z.string().describe("Coin ID (bitcoin, ethereum)") },
  safeTool(async ({ coin }) => { /* ... */ })
);

// ─── Tool 3: Search News ────────────────────────────────────
server.tool("search_news", "Search financial news by keyword or ticker",
  { query: z.string(), limit: z.number().optional().default(5) },
  safeTool(async ({ query, limit }) => { /* ... */ })
);

// ─── Tool 4: Earnings Calendar ──────────────────────────────
server.tool("get_earnings_calendar", "Get upcoming earnings dates",
  { days: z.number().optional().default(7).describe("Lookahead days") },
  safeTool(async ({ days }) => { /* ... */ })
);

// ─── Tool 5: Market Regime ──────────────────────────────────
server.tool("get_market_regime", "Detect current market regime (risk-on/off/neutral)",
  {},
  safeTool(async () => { /* VIX + breadth + momentum → regime */ })
);

// ─── Tool 6: Screen Stocks ──────────────────────────────────
server.tool("screen_stocks", "Screen stocks by technical and fundamental criteria",
  {
    strategy: z.enum(["oversold_bounce", "momentum", "breakout", "value"]),
    min_market_cap: z.number().optional().default(1e9)
  },
  safeTool(async ({ strategy, min_market_cap }) => { /* ... */ })
);

// ─── Tool 7: Compare Stocks ─────────────────────────────────
server.tool("compare_stocks", "Compare 2-5 stocks side by side",
  { symbols: z.array(z.string()).min(2).max(5) },
  safeTool(async ({ symbols }) => { /* ... */ })
);

// ─── Resource: Watchlist ────────────────────────────────────
server.resource("watchlist", "finance://watchlist",
  { description: "User's stock watchlist" },
  async () => ({ contents: [{ uri:"finance://watchlist",
    mimeType:"application/json",
    text: JSON.stringify(["AAPL","MSFT","GOOGL","NVDA","AMZN","BTC","ETH"])
  }] })
);

// ─── Start ──────────────────────────────────────────────────
await server.connect(new StdioServerTransport());