Fruit Stand Fund Returns

Fruit Stand Fund Returns — Servidor MCP

Retornos totais acumulados e por ano-calendário ao vivo para mais de 32.000 fundos mútuos e ETFs dos EUA, como um servidor MCP. Peça a um assistente de IA para comparar o desempenho de fundos por ticker — sem contrato com Morningstar ou Bloomberg, nível gratuito, mesma chave de API da REST API.

MCP remoto e hospedado via Streamable HTTP · funciona com Claude, Cursor e qualquer cliente MCP · obtenha uma chave de API gratuita

---

Início rápido

1. Obtenha uma chave de API

Cadastre-se em app.fruitstand.dev — o nível gratuito não exige cartão de crédito.

2. Aponte seu cliente para o endpoint

https://api.fruitstand.dev/mcp

MCP remoto via Streamable HTTP, autenticado com sua chave de API como token bearer.

Clientes MCP remotos nativos (Claude web/desktop "Adicionar conector personalizado", Cursor, etc.) — use a URL acima e adicione o cabeçalho:

Authorization: Bearer YOUR_API_KEY

Configuração do Claude Desktop (claude_desktop_config.json) — faça a ponte para o endpoint remoto com mcp-remote:

{
  "mcpServers": {
    "fruit-stand": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.fruitstand.dev/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Reinicie o cliente e as ferramentas do Fruit Stand aparecerão.

Docker — a mesma ponte como contêiner (o Dockerfile deste repositório), para clientes que aceitam um comando docker:

{
  "mcpServers": {
    "fruit-stand": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "FRUITSTAND_API_KEY", "ghcr.io/fruitstanddev/fruitstand-mcp"],
      "env": { "FRUITSTAND_API_KEY": "YOUR_API_KEY" }
    }
  }
}

O contêiner apenas faz a ponte do stdio para api.fruitstand.dev/mcp — todos os dados vêm do servidor hospedado.

3. Faça uma pergunta

"Compare os retornos de 1 ano, 5 anos e desde o início do SPY, QQQ e VTI, e diga qual teve o melhor ano-calendário de 2022."

O assistente chama batchTrailingReturns e batchCalendarReturns e resume.

---

Ferramentas

Seis ferramentas, espelhando a REST API. Os retornos vêm como frações decimais (0.1234 = 12,34%).

Ferramenta	Função	Principais entradas
searchFunds	Buscar / listar o universo de fundos (paginação por chave)	q, type, country, exchange, cursor, limit
getFund	Metadados do fundo por ticker	code
getTrailingReturns	Retornos acumulados de um fundo (mais recentes ou em uma data)	code, as_of?
batchTrailingReturns	Retornos acumulados de até 100 fundos em uma única chamada	codes[], as_of?
getCalendarReturns	Retorno por ano-calendário de um fundo (mais recente ou em um ano específico)	code, year?
batchCalendarReturns	Retornos por ano-calendário de até 100 fundos em uma única chamada	codes[], year?

Os tickers usam a forma SYMBOL.US (ex.: SPY.US, VTSAX.US).

---

Sobre os dados

• Cobertura: ~32.000 fundos mútuos e ETFs dos EUA.
• Retornos acumulados: janelas padrão até desde o início, retorno total (distribuições reinvestidas).
• Retornos por ano-calendário: retorno total do ano inteiro por ano-calendário.
• Atualização: atualizados diariamente pelo mesmo pipeline que constrói os conjuntos de dados do Fruit Stand no Snowflake Marketplace.
• Metodologia e referência de campos: app.fruitstand.dev/api/mcp e a documentação.

As chamadas de ferramentas MCP são medidas exatamente como as chamadas REST e contam para sua cota mensal. Uma chave sem plano ativo recebe um 403 nas chamadas de ferramentas.

---

Links

• Obter chave / preços: https://app.fruitstand.dev/pricing
• Documentação de configuração do MCP: https://app.fruitstand.dev/api/mcp
• Referência da REST API: https://app.fruitstand.dev/api
• Site de marketing: https://fruitstand.dev
• Status do pipeline / conjuntos de dados: https://fruitstand.dev/datasets

Licença

MIT — este repositório contém a documentação pública e os metadados do conector para o serviço hospedado; a implementação do serviço fica em um repositório separado.