Product

Vraag je AI-assistent naar je portefeuille

Je dashboard weet wat je portefeuille heeft gedaan. Je AI-assistent weet hoe je dingen uitlegt, vergelijkt en in een tabel zet. Je kunt de twee koppelen: maak een token aan in BullBenchmark, plak het in Claude Desktop, Cursor of ChatGPT, en stel je vragen daar in plaats van ze van een grafiek af te lezen.

De koppeling mag met opzet alleen lezen. Er is geen tool die een instelling verandert, geen tool die een bestand uploadt, geen tool die een order plaatst, en geen manier waarop de assistent bij het account van iemand anders komt.

Dit artikel legt uit wat de koppeling kan zien, wat ze niet kan doen, en hoe je het in alle drie de assistenten instelt.

Wat de koppeling is

BullBenchmark spreekt MCP, het Model Context Protocol, een open standaard om een taalmodel een set tools te geven die het mag aanroepen. Ons endpoint biedt zes tools, allemaal alleen-lezen, en allemaal beperkt tot het ene account waar jouw token bij hoort.

Het oordeel. Je rendement tegenover de S&P 500 en de Nasdaq 100 over hetzelfde venster, per jaar en in totaal.
De samenvatting. Waarde, ingelegd geld, koersresultaat, ontvangen dividend, kosten, totaalrendement, basisvaluta.
De posities. Naam, ticker of ISIN, aantal aandelen, waarde, gewicht, rendement, hoe elke positie het deed tegenover de S&P 500, plus je eigen groep en label.
Het dividend. Ontvangen per maand, verwacht over de komende twaalf maanden, yield on cost (het dividendrendement op je aankoopprijs), groei tegenover het jaar ervoor.
De prestaties. Tijdgewogen rendement tegenover de index over 1m, 3m, 6m, 1j, 3j en de hele historie, en je drawdown.
De uploads. De namen, data en het aantal regels van de bestanden die je hebt geïmporteerd.

Die zes tools zijn alles wat er is. De getallen zijn dezelfde die je dashboard toont, berekend door dezelfde code, dus een cijfer dat je assistent voorleest is het cijfer op je scherm.

Wat je moet weten voordat je een token aanmaakt

Het model draait op je eigen AI-abonnement en niet op het onze, dus de koppeling kost je bij BullBenchmark niets extra's. De keerzijde is dat alles waar je naar vraagt naar je eigen AI-aanbieder gaat en daar onder diens voorwaarden blijft staan.

Geef je je portefeuille liever niet aan een derde partij, dan werkt het dashboard zonder token zoals voorheen. De functie staat uit tot je hem aanzet, en een token intrekken op de pagina Account stopt de koppeling meteen.

Er gelden twee kleinere grenzen. De koppeling vraagt een lopend abonnement of een lopende proefperiode, net als het dashboard, en zodra dat afloopt geeft een tool-aanroep een kale melding "subscription needed".

Er geldt ook een limiet van zestig aanroepen per minuut per account en dertig per token, die een normaal gesprek niet haalt maar een script in een lus wel.

Zo maak je een token aan

Open het dashboard en klik op Account.
Zoek "Een AI-assistent koppelen".
Geef het token een naam die je later herkent, bijvoorbeeld de machine waarop het komt te staan, en maak het aan.
De waarde begint met "bbm_" en wordt één keer getoond. Wij bewaren er alleen een hash van, dus raak je hem kwijt, dan maak je een nieuwe aan in plaats van de oude op te zoeken.

Een account kan maximaal vijf actieve tokens hebben, en elk token kun je afzonderlijk intrekken.

Claude Desktop

Open het configuratiebestand vanuit de ontwikkelaarsinstellingen in Claude Desktop.
Voeg het blok hieronder toe, met je eigen token in plaats van de plaatshouder.
Start de app opnieuw.

Voor deze opzet moet Node.js geïnstalleerd zijn, want mcp-remote is het onderdeel dat de authorization-header voor je meedraagt.

{
  "mcpServers": {
    "bullbenchmark": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://bullbenchmark.com/api/mcp",
               "--header", "Authorization: Bearer bbm_your_token_here"]
    }
  }
}

Claude in de browser werkt voorlopig anders. Een connector die je daar toevoegt, verwacht je via OAuth te laten inloggen, en dat biedt dit endpoint nog niet.

Met alleen een token kom je er via de browser dus niet in. Ondersteuning voor OAuth staat op de lijst, en Claude Desktop werkt nu al.

Cursor

Cursor spreekt hetzelfde protocol en kan de header zelf meedragen, dus extra gereedschap is niet nodig. Zet het blok hieronder in .cursor/mcp.json in een project, of in ~/.cursor/mcp.json om het overal beschikbaar te hebben.

{
  "mcpServers": {
    "bullbenchmark": {
      "url": "https://bullbenchmark.com/api/mcp",
      "headers": { "Authorization": "Bearer bbm_your_token_here" }
    }
  }
}

ChatGPT

In ChatGPT zitten connectors die je zelf toevoegt achter de ontwikkelaarsmodus, en in welke abonnementen die zit, is al meer dan eens veranderd, dus kijk wat je eigen account biedt voordat je begint.

Kun je er een toevoegen, dan heeft die het adres van het endpoint nodig en een authorization-header die je token draagt.

https://bullbenchmark.com/api/mcp
Authorization: Bearer bbm_your_token_here

Wat je kunt vragen zodra het werkt

De nuttige vragen zijn de vragen die vervelend zijn om al klikkend te beantwoorden. Vier voorbeelden van het soort vraag waar de koppeling voor gemaakt is.

Welke van mijn posities versloegen de S&P 500 over het geld dat erin zat, en welke niet?
Groepeer mijn posities per sector en vertel me wat elke groep bijdroeg.
Hoeveel dividend kwam er vorig jaar per maand binnen, en hoe zien de komende twaalf maanden eruit bij de huidige aantallen aandelen?
Hoe diep was mijn ergste drawdown, wanneer was die, en hoe lang duurde het herstel?

De koppeling vertelt je niet wat je moet kopen, en wij ook niet. Ze leest wat je portefeuille heeft gedaan, en de conclusies blijven van jou. Komt je assistent toch met een aanbeveling, dan komt die uit het model en niet uit je gegevens, en het model weet niets over jouw omstandigheden.

Een noot over de cijfers

Alles wat de assistent leest komt uit dezelfde rekenmotor als het dashboard, dus gelden dezelfde grenzen. Rendementen zijn tijdgewogen, wat betekent dat inleg en opname nooit als rendement meetellen en ontvangen dividend wel.

Koersen worden elk uur ververst zolang de beurzen open zijn en worden na het slot in de VS vastgezet op de officiële slotkoersen, dus een cijfer dat midden op de handelsdag wordt genoemd is zo vers als de laatste verversing.

De reeksen worden uitgedund voordat ze vertrekken. Een grafiek van twintig jaar bestaat uit duizenden dagpunten, en de koppeling stuurt er hoogstens vierentwintig per reeks, genoeg om de vorm te beschrijven zonder de context van je assistent vol te zetten.

In het kort

De koppeling mag alleen lezen en biedt zes tools, allemaal beperkt tot het account waar je token bij hoort.
Het model draait op je eigen AI-abonnement, en waar je naar vraagt gaat naar je eigen AI-aanbieder.
Een token maak je aan op de pagina Account, het wordt één keer getoond en je kunt het daar op elk moment intrekken.
De getallen zijn dezelfde als op het dashboard, met dezelfde uurkoersen en dezelfde tijdgewogen methode.

BullBenchmark leest de transactie-export van je broker en zet je rendement naast de S&P 500 en de Nasdaq 100, gevoed met dezelfde inleg op dezelfde dagen, in je eigen valuta. De eerste twee weken zijn gratis en er is geen creditcard nodig.

Lees ook: Zo controleer je of je de S&P 500 verslaat · Privacybeleid