Bedrijfsdata via API of MCP: welke ingang past bij je AI-agent?

API of MCP voor bedrijfsdata: het korte antwoord

Wil je bedrijfsdata gebruiken in een AI-agent, dan kies je tussen een API en een MCP-server. MCP past als de agent zelf moet bepalen welke stap hij zet. Heb je een vast script dat elke keer hetzelfde doet, dan is de API handiger. Bij FirmTrove krijg je via beide dezelfde gegevens, met dezelfde regels.

Het verschil is wie beslist welke stap volgt: jouw code of het taalmodel.

Wanneer kies je voor MCP?

MCP is gemaakt voor gesprekken. De agent vraagt eerst welke tools er zijn en leest hun beschrijving. Daarna kiest hij zelf. Vraag je hoeveel installatiebedrijven er in een provincie zitten, dan telt hij. Vraag je om vijf voorbeelden met website, dan kan hij filteren op website.

Dat werkt goed als je in Claude Code, Codex of Cursor zit en je vraag per keer verandert. Je weet dan vooraf niet welke filters nodig zijn, en dat hoeft ook niet.

Hoe je de koppeling maakt, staat stap voor stap in bedrijfsdata via MCP koppelen.

Wanneer kies je voor de REST API?

Met de REST API stuur je een vaste aanvraag en krijgt elke keer JSON in dezelfde vorm terug. Dat past bij werk dat zonder mens moet draaien.

• Een nachtelijk script dat nieuwe bedrijven in je CRM zet.
• Een rapport dat elke week dezelfde telling maakt.

Een voorbeeld: GET https://app.firmtrove.nl/api/companies?q=software&province=Utrecht met je sleutel als Bearer-token gaf op 23 september 2026 een totaal van 87 bedrijven met software in de naam en een eerste pagina van 12. Dezelfde vraag via de MCP-tool firmtrove_search_companies gaf ook 87. Alle aanroepen staan op de pagina API en MCP.

Wat voor beide hetzelfde is

1. Eén sleutel. Je maakt hem in je account en trekt hem in wanneer je wilt.
2. CSV, REST API en MCP delen één rijentegoed per kalendermaand. Elke CSV-rij telt mee. API en MCP tellen een bedrijfs-ID samen één keer per kalendermaand.
3. Labels. Een veld dat je niet mag doorgeven, blijft weg en staat met de reden in withheld.
4. Export. Een export met dezelfde sleutel voor dubbele aanvragen geeft via MCP en REST hetzelfde bewijs terug en telt maar één keer.

Welke bron achter een veld zit en welke licentie daarbij hoort, lees je op bronnen en rechten. De MCP-specificatie over tools legt uit hoe een agent tools ontdekt en aanroept.

Combineer ze gerust

Verken eerst met een agent via MCP, bijvoorbeeld hoeveel bedrijven er in een sector en provincie zitten. Staat de vraag vast, laat de agent dan een script schrijven dat de REST API aanroept. Dat script draait daarna zonder taalmodel, dus zonder extra tokens en met een vaste uitkomst.

Veelgestelde vragen

Is MCP langzamer dan de API?

De zoekopdracht zelf is dezelfde. Een agent doet er wel stappen omheen: tools opvragen, kiezen, het antwoord lezen. Voor een vast proces is een script met de API daarom meestal sneller en goedkoper.

Kan ik met de API ook exporteren?

Ja. POST /api/exports met bedrijfs-id's en een vaste sleutel voor dubbele aanvragen geeft een download met bronvermelding. Via MCP doet firmtrove_export hetzelfde.

Wat kost het?

De API en MCP zitten in elk plan, ook in Free. Free geeft 100 gedeelde rijen per kalendermaand, maximaal 100 per CSV-export. Pro kost €29 per maand of €290 per jaar vooraf, exclusief btw. Bij maandbetaling begin je met 5.000 rijen en krijg je 2.500 meer per opeenvolgende betaalde maand, tot 25.000. Jaarbetaling geeft direct 25.000 rijen per kalendermaand. Bestaande betaalde accounts behouden 25.000 rijen per kalendermaand. Een Pro CSV-export bevat maximaal 5.000 rijen. Zie de prijzen.