elliotfoster-mcp

Analysen brasilianischer Investmentfonds für KI-Clients über das Model Context Protocol (MCP).

Verbinden Sie Claude Desktop, Cursor, ChatGPT oder einen beliebigen MCP-kompatiblen Client, um über 30.000 brasilianische Investmentfonds abzufragen — täglicher NAV, vollständige Bestände (CDA), Durchschau (Look-through) bei Dachfonds, Portfolio-Überschneidungsanalysen sowie Ihre persönlichen Favoriten/Watchlist.

Server-URL: https://elliotfoster.vercel.app/api/mcp Web-App + Schlüsselgenerierung: elliotfoster.vercel.app

Die Quelldaten stammen aus dem öffentlichen CVM (Comissão de Valores Mobiliários) Informe Diário und CDA sowie aus den Zinssatzreihen der Banco Central. Die Plattform verarbeitet, validiert und stellt diese in einem strukturierten Format bereit, das für die Nutzung durch LLM-Tools optimiert ist.

Schnellstart

1. Einen Schlüssel erhalten

Erstellen Sie ein Konto unter elliotfoster.vercel.app, melden Sie sich an und besuchen Sie /settings/integrations. Generieren Sie einen neuen Schlüssel und kopieren Sie ihn (der Rohschlüssel wird nur einmal angezeigt).

2. Ihren MCP-Client konfigurieren

Claude Desktop

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "elliotfoster": {
      "url": "https://elliotfoster.vercel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer ef_..."
      }
    }
  }
}

Starten Sie Claude Desktop neu.

Cursor

Fügen Sie in den Cursor-Einstellungen unter MCP Folgendes hinzu:

{
  "elliotfoster": {
    "url": "https://elliotfoster.vercel.app/api/mcp",
    "headers": {
      "Authorization": "Bearer ef_..."
    }
  }
}

ChatGPT (Custom GPT / Connectors)

Verweisen Sie in den Aktionen eines Custom GPT oder über die Connectors-Schnittstelle auf https://elliotfoster.vercel.app/api/mcp mit Authorization: Bearer ef_... als Header.

Claude Code

claude mcp add --transport http --header "Authorization=Bearer ef_..." elliotfoster https://elliotfoster.vercel.app/api/mcp

3. Ausprobieren

Fragen Sie Ihr LLM:

"Verwende elliotfoster, um nach Fonds mit 'XP' im Namen zu suchen"
"Wie hoch ist die Überschneidung der Bestände zwischen den Fonds 12.345.678/0001-90 und 98.765.432/0001-21?"
"Füge Fonds X zu meinen Favoriten hinzu"
"Finde Aktienfonds mit geringer Korrelation zu Fonds Y"

Tools

10 aufrufbare Tools, 1 Ressource, 5 vorgefertigte analytische Prompts.

Tool	Was es tut
`search_funds`	Suche nach Name, Manager, Administrator oder CNPJ. Filtern nach Typ (FI, FIC, FII, FIP, FIDC, FIAGRO, ETF). Seitengröße auf 25 begrenzt.
`get_fund`	Abrufen von Metadaten + aktuellem NAV für einen Fonds per CNPJ. Akzeptiert formatiert (`12.345.678/0001-90`) oder roh (`12345678000190`).
`list_fund_types`	Zählungen pro Fondstyp — nützlich für die Erkundung.
`get_nav_history`	Tägliche NAV-Reihe für einen Fonds. Optionaler Datumsbereich und Limit (maximal 1000 Tage).
`list_holding_dates`	Verfügbare Berichtsdaten für Bestände (CDA) eines Fonds.
`get_holdings`	Vollständige Portfoliozusammensetzung für ein Datum. Enthält einen `confidential_count`-Indikator für Positionen unter der Vertraulichkeit der CVM Resolução 172/2022.
`get_look_through`	Rekursives Auflösen von Dachfonds-Positionen bis zu 3 Ebenen tief. Aggregiert zugrunde liegende Vermögenswerte mit proportionalen Gewichten.
`compare_overlap`	Jaccard-Überschneidung + geteiltes Gewicht zwischen zwei Fonds-Portfolios für ein Berichtsdatum.
`list_favorites`	Ihre favorisierten Fonds.
`add_favorite` / `remove_favorite`	Verwalten Sie Ihre Watchlist direkt vom LLM-Client aus.

Ressource

fund://<cnpj> — adressierbare Fonds-Metadaten, cachebar durch Clients, die MCP-Ressourcen unterstützen.

Vorgefertigte Prompts

compare_funds_performance — Seite-an-Seite Rendite / Volatilität / Sharpe-vs-CDI für bis zu 5 Fonds
find_uncorrelated_funds — Screening nach Fonds mit geringer Korrelation gegenüber einer Benchmark
analyze_fund_holdings — Top-10-Positionen, HHI-Konzentration, Durchschau, Vertraulichkeits-Flags
check_portfolio_overlap — paarweise Redundanzprüfung über 2-5 Fonds
screen_funds_by_risk — Filtern nach maximaler Volatilität und minimaler Sharpe-Ratio

Alle Prompts erzeugen standardmäßig Ausgaben in pt-BR (passend zur Sprache der Quelldaten).

Spezifikation


Endpunkt	`https://elliotfoster.vercel.app/api/mcp`
Transport	Streamable HTTP (MCP-Spezifikation Nov 2025)
Discovery	`/.well-known/oauth-protected-resource` (RFC 9728)
Auth	API-Schlüssel (`Authorization: Bearer ef_...`). OAuth 2.1 Protected-Resource-Metadaten werden unter `/.well-known/oauth-protected-resource` veröffentlicht, um die Vorwärtskompatibilität mit MCP-Clients zu gewährleisten, die RFC 9728 + Dynamic Client Registration implementieren; in der Praxis reifen Auto-Discovery-Flows im Ökosystem noch, daher sind API-Schlüssel heute der empfohlene Weg.
Ratenbegrenzung	Es gelten nutzerspezifische Ratenbegrenzungen (derzeit großzügig; stufenbasierte Preisgestaltung für hohe Volumina folgt)
Dezimalpräzision	Finanzwerte auf 6 Dezimalstellen gerundet. Der Top-Level-Hinweis `_precision_note` dokumentiert dies bei jeder analytischen Antwort.
CNPJ-Format	Alle CNPJ-Eingaben akzeptieren formatierte oder rohe 14-stellige Werte; serverseitig normalisiert + validiert.
Paginierung	`search_funds` Seitengröße auf 25 begrenzt, maximal 20 Seiten pro Sitzung (500 Fonds). Für eine breitere Erkundung verwenden Sie Filter.

Datenschutz & Daten

Öffentliche Fondsdaten (CVM Informe Diário, CDA, Banco Central-Zinssätze) werden mit allen Nutzern geteilt.
Nutzerspezifischer Status (Favoriten, Audit-Log) ist via Ihrer WorkOS-Benutzer-ID RLS-geschützt — weder Tools noch die Datenbank legen Ihren Status gegenüber anderen Konten offen.
Es werden keine persönlichen Handelsdaten gespeichert. Dies ist eine Plattform für Fondsrecherche; sie verbindet sich nicht mit Broker-Konten.
Audit-Log: Tool-Aufrufe werden zur Abrechnung und Missbrauchsprävention aufgezeichnet. Das Log ist strikt nutzerspezifisch — Sie können Ihre eigene Nutzung einsehen; andere Konten können dies nicht.

Quelle

Der MCP-Server ist innerhalb der Closed-Source-Web-App implementiert. Dieses Repository bietet Installationsanweisungen, Beispiele und fungiert als kanonische Quelle für KI-Suchmaschinen, die MCP-Server indizieren. Probleme und Feedback sind hier willkommen.

Für Datenlizenzierung oder kommerzielle Anfragen: siehe elliotfoster.vercel.app.

Lizenz

Die README und Beispielkonfigurationen in diesem Repository sind MIT-lizenziert. Der MCP-Server selbst ist proprietär.

Erstellt mit mcp-handler auf Next.js + Supabase + WorkOS.

Elliot Foster – Brazilian Funds