/ Diretório / Playground / mcp_massive
● Comunidade massive-com ⚡ Instantâneo

mcp_massive

por massive-com · massive-com/mcp_massive

Query Massive.com financial market data — stocks, options, crypto, fundamentals — with natural language endpoint discovery and built-in DataFrame analysis.

mcp_massive is 4 composable tools: search endpoints by description, get endpoint docs, call any API with optional DataFrame storage, and run SQL across stored DataFrames. Also ships built-in functions for option pricing (Black-Scholes), returns, and technical indicators.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

massive.replay ▶ pronto
0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "massive": {
      "command": "uvx",
      "args": [
        "mcp_massive"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "massive": {
      "command": "uvx",
      "args": [
        "mcp_massive"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "massive": {
      "command": "uvx",
      "args": [
        "mcp_massive"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "massive": {
      "command": "uvx",
      "args": [
        "mcp_massive"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "massive",
      "command": "uvx",
      "args": [
        "mcp_massive"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json
{
  "context_servers": {
    "massive": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp_massive"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add massive -- uvx mcp_massive

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: mcp_massive

Analyze an options chain and price theoretical value

👤 Options traders, quant hobbyists ⏱ ~20 min advanced

Quando usar: You want to look at AAPL options, compare IV to historical vol, and spot-check Black-Scholes values.

Pré-requisitos
  • Massive.com API key — massive.com signup — free tier
Fluxo
  1. Find the right endpoint
    Search endpoints: 'options chain for a given ticker and expiry'.✓ Copiado
    → Best-match endpoint + params
  2. Pull chain
    Call the endpoint for AAPL with the next monthly expiry. Store as DataFrame 'aapl_chain'.✓ Copiado
    → DataFrame stored; head preview
  3. Analyze
    Run SQL: SELECT strike, iv, bid, ask FROM aapl_chain WHERE expiry=... ORDER BY strike. Price Black-Scholes for each and show deltas to market mid.✓ Copiado
    → Table of strikes with BS-vs-market

Resultado: Hands-on options screen without writing Python yourself.

Armadilhas
  • Delayed data on free tier — Check data timestamps; paid tier for real-time

Compute total return for a portfolio over a period

👤 Investors tracking performance ⏱ ~15 min intermediate

Quando usar: Year-end — how did my 10-position portfolio perform vs SPY?

Fluxo
  1. Fetch prices
    For each ticker in [list], get daily close prices from Jan 1 to today. Store each as a DataFrame.✓ Copiado
    → Price series per ticker
  2. Compute weighted return
    Using my weights [paste], compute weighted portfolio return. Compare to SPY return over the same period.✓ Copiado
    → Portfolio YTD vs SPY YTD

Resultado: Quick portfolio report without spreadsheets.

Armadilhas
  • No dividend reinvestment accounting by default — Use adjusted-close series; ask Claude to note the assumption
Combine com: filesystem

Screen stocks on fundamental criteria

👤 Value investors ⏱ ~20 min intermediate

Quando usar: You want US large-cap stocks with P/E < 15, dividend yield > 3%, and positive 5y earnings growth.

Fluxo
  1. Find endpoints
    Search endpoints for 'fundamentals' and 'screener'. Pick the right one.✓ Copiado
    → Endpoint choice
  2. Screen
    Pull fundamentals for S&P 500 components. Store as DataFrame. Run SQL to filter my criteria.✓ Copiado
    → Matching tickers with key ratios

Resultado: A shortlist to research further.

Armadilhas
  • Fundamentals data lags quarterly filings by weeks — Check as_of dates

Combinações

Combine com outros MCPs para 10× de alavancagem

massive + filesystem

Persist analysis to CSV for Excel follow-up

After the screen, export the final DataFrame as /reports/screen-YYYY-MM-DD.csv.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
search_endpoints query: str First step — discover what's available free
get_endpoint_docs endpoint_id Before calling an endpoint you don't know free
call_api endpoint, params, store_as?: str Actually fetch data; store to re-query 1 API call
query_data sql: str Analyze stored DataFrames without re-fetching free

Custo e limites

O que custa rodar

Cota de API
Per Massive.com plan
Tokens por chamada
Raw series can be large — use DataFrame + SQL to slice
Monetário
Free tier exists; paid for real-time / higher volume
Dica
store_as + query_data is dramatically cheaper than re-fetching and re-parsing each time.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: MASSIVE_API_KEY env var
Saída de dados: Queries to massive.com

Solução de problemas

Erros comuns e correções

401 from Massive

Check API key. Verify it's still active in the dashboard.

DataFrame limit exceeded (50 / 50k rows default)

Raise via env config or chunk via SQL limits.

SQL syntax error in query_data

Query engine is a subset — check docs for supported functions.

Alternativas

mcp_massive vs. outros

AlternativaQuando usarTroca
Alpaca MCPYou want trading too, not just dataDifferent broker; narrower data
Polygon.io / Alpha Vantage direct + fetch MCPYou want full API controlYou write the fetching and parsing yourself

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills