Fruit Stand Fund Returns

Fruit Stand Fund Returns — Servidor MCP

Rentabilidades totales en vivo (trailing y por año calendario) para más de 32,000 fondos mutuos y ETFs de EE. UU., como un servidor MCP. Pídele a un asistente de IA que compare el rendimiento de fondos por ticker — sin contrato con Morningstar ni Bloomberg, nivel gratuito, misma clave de API que la API REST.

MCP remoto alojado sobre Streamable HTTP · funciona con Claude, Cursor y cualquier cliente MCP · obtén una clave de API gratuita

---

Inicio rápido

1. Obtén una clave de API

Regístrate en app.fruitstand.dev — el nivel gratuito no requiere tarjeta.

2. Apunta tu cliente al endpoint

https://api.fruitstand.dev/mcp

MCP remoto sobre Streamable HTTP, autenticado con tu clave de API como token bearer.

Clientes MCP remotos nativos (Claude web/escritorio "Agregar conector personalizado", Cursor, etc.) — usa la URL anterior y agrega el encabezado:

Authorization: Bearer YOUR_API_KEY

Configuración de Claude Desktop (claude_desktop_config.json) — conecta al endpoint remoto con mcp-remote:

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

Reinicia el cliente y las herramientas de Fruit Stand aparecerán.

Docker — el mismo puente como contenedor (el Dockerfile de este repositorio), para clientes que aceptan un 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" }
    }
  }
}

El contenedor solo conecta stdio a api.fruitstand.dev/mcp — todos los datos provienen del servidor alojado.

3. Haz una pregunta

"Compara las rentabilidades a 1 año, 5 años y desde el inicio de SPY, QQQ y VTI, y dime cuál tuvo el mejor año calendario 2022."

El asistente llama a batchTrailingReturns y batchCalendarReturns y resume.

---

Herramientas

Seis herramientas, que reflejan la API REST. Las rentabilidades se devuelven como fracciones decimales (0.1234 = 12.34%).

Herramienta	Función	Entradas clave
searchFunds	Buscar / listar el universo de fondos (paginación por keyset)	q, type, country, exchange, cursor, limit
getFund	Metadatos del fondo por ticker	code
getTrailingReturns	Rentabilidades trailing para un fondo (últimas o a una fecha)	code, as_of?
batchTrailingReturns	Rentabilidades trailing para hasta 100 fondos en una sola llamada	codes[], as_of?
getCalendarReturns	Rentabilidad por año calendario para un fondo (última o un año dado)	code, year?
batchCalendarReturns	Rentabilidades por año calendario para hasta 100 fondos en una sola llamada	codes[], year?

Los tickers usan la forma SYMBOL.US (p. ej., SPY.US, VTSAX.US).

---

Acerca de los datos

• Cobertura: ~32,000 fondos mutuos y ETFs de EE. UU.
• Rentabilidades trailing: ventanas estándar hasta desde el inicio, retorno total (distribuciones reinvertidas).
• Rentabilidades por año calendario: retorno total de año completo por año calendario.
• Actualización: se actualizan diariamente desde el mismo pipeline que construye los conjuntos de datos de Fruit Stand en Snowflake Marketplace.
• Metodología y referencia de campos: app.fruitstand.dev/api/mcp y la documentación.

Las llamadas a herramientas MCP se miden exactamente igual que las llamadas REST y cuentan contra tu cuota mensual. Una clave sin plan activo recibe un 403 en las llamadas a herramientas.

---

Enlaces

• Obtén una clave / precios: https://app.fruitstand.dev/pricing
• Documentación de configuración de MCP: https://app.fruitstand.dev/api/mcp
• Referencia de la API REST: https://app.fruitstand.dev/api
• Sitio de marketing: https://fruitstand.dev
• Estado del pipeline de datos / conjuntos de datos: https://fruitstand.dev/datasets

Licencia

MIT — este repositorio contiene la documentación pública y los metadatos del conector para el servicio alojado; la implementación del servicio vive en un repositorio separado.