MCP

MCP-server

Vraag Claude, ChatGPT of Cursor in gewone taal naar je leads. De MCP-server van Gemlead geeft AI-assistenten de gegevens en acties van de API, met jouw toestemming.

Wat het is

Het Model Context Protocol is de open standaard waarmee AI-assistenten externe tools aanroepen. Koppel Gemlead één keer en je assistent kan je hete leads doorzoeken, je gesprekken lezen en beantwoorden, bekijken hoe een campagne het doet of een export starten, gewoon in de chat. Hij ziet alleen het X-account dat je koppelt, en de regels van de API gelden ook hier, dus de abonnementen Business en Enterprise en dezelfde scopes.

De server werkt met Streamable HTTP. Claude en ChatGPT loggen in via OAuth, Cursor en Claude Code kunnen een API-sleutel als bearer token meesturen.

Server-URL

https://gemlead.ai/mcp

Instellen

Open in Claude Customize en daarna Connectors.
Klik op Add en daarna op Add custom connector.
Noem hem Gemlead en plak https://gemlead.ai/mcp als server-URL.
Laat Use Claude's published identity staan als OAuth-client en klik op Add.
Klik op Connect, log in bij Gemlead en kies het X-account.

Zet Gemlead in een chat aan via het menu +, onder Connectors. Claude Desktop en de mobiele apps gebruiken dezelfde connectors als je Claude-account, je hoeft verder niets in te stellen.

Bij Team en Enterprise voegt een eigenaar Gemlead toe in Organization settings, Connectors, waarna elk lid op Connect klikt. Het Free-abonnement van Claude staat één eigen connector toe.

Andere clients

Elke client die Streamable HTTP ondersteunt, maakt op dezelfde manier verbinding, met de URL en een header Authorization. Test de server met de MCP Inspector.

Terminal

npx @modelcontextprotocol/inspector --cli https://gemlead.ai/mcp \
  --transport http \
  --header "Authorization: Bearer $GEMLEAD_API_KEY" \
  --method tools/list

Meerdere X-accounts

Een verbinding geldt voor één X-account. Wil je met meerdere tegelijk werken, voeg Gemlead dan één keer per account toe, elk met een eigen server-URL, https://gemlead.ai/mcp/ gevolgd door een naam die je zelf kiest, zoals https://gemlead.ai/mcp/acme en https://gemlead.ai/mcp/julien. De naam is alleen een label en bestaat uit letters, cijfers, - en _.

Verbind ze een voor een en kies op de toestemmingspagina van Gemlead het juiste X-account. Is de naam gelijk aan de X-gebruikersnaam van het account, dan wordt dat account voor je gekozen. Staan de accounts onder verschillende Gemlead-logins, log dan eerst in met de juiste voordat je verbinding maakt.

Elke verbinding leest en werkt alleen in haar eigen account en vertelt de assistent om welk @handle het gaat, dus een DM vertrekt altijd vanaf het account dat je hebt gevraagd. Geef elke connector de naam van zijn account, zoals Gemlead Acme, om ze in de chat uit elkaar te houden.

Tools

De server heeft 67 tools, één voor elke actie van de API. Leestools lezen alleen. Schrijftools wijzigen gegevens of doen iets op X vanaf je account, dus ze hebben de scope write nodig, en de assistent vraagt je om bevestiging voordat hij iets verstuurt, start of verwijdert.

Klik op de MCP-tag van een endpoint in de API-referentie om bij de bijbehorende tool uit te komen.

Geen enkele tool stelt de X Chat-code in of verwijdert hem, en dat is bewust, zodat een code nooit door een AI-chat gaat. Stel hem in via de app of met De X Chat-code instellen.

Leads

search_leadsScope read
Leads met de filters van Leads opvragen, zoals de hete leads van één persona die deze week zijn gevonden.
Optioneelpersona_idstatusscore_minscore_maxhotscored_afterscored_beforefound_afterfound_beforeorderlimitcursor
get_leadScope read
Eén lead met profiel, score en reden.
Verplichtlead_id
update_leadScope write
Zet metadata op een lead, of sluit hem af als je er klaar mee bent.
Verplichtlead_id
Optioneelmetadatastatus
get_lead_originScope read
Hoe Gemlead een lead vond, de post waardoor hij opdook en zijn campagnes.
Verplichtlead_id
lead_actionScope write
Scoort een lead opnieuw voor maximaal 2 credits per lead: 1 voor de eerste ronde, 1 extra voor de diepe score als de lead erdoor komt. Of leest zijn X-profiel opnieuw, of volgt of ontvolgt hem vanaf je X-account.
Verplichtlead_idaction
convert_lead_to_sourceScope write
Maakt van een lead een bron van zijn persona, om te lezen wie hij volgt, wie hem volgt of wie op zijn posts reageert.
Verplichtlead_id
Optioneelmethod
delete_leadScope write
Verwijdert een lead en stopt hem in elke campagne. De assistent vraagt eerst om bevestiging.
Verplichtlead_id

Persona's

list_personasScope read
Je persona's met hun aantallen en de cijfers van vandaag.
Optioneellimitcursor
get_personaScope read
Eén persona met de statistieken.
Verplichtpersona_id
create_personaScope write
Maakt een persona aan met beschrijving, trefwoorden, concurrenten en startbronnen. Scoren kost maximaal 2 credits per lead: 1 voor de eerste ronde, 1 extra voor de diepe score als de lead erdoor komt.
Verplichtnamedescription
Optioneelwebsitemarketkeywordscompetitorsavoidmin_followersinclude_closed_inboxesauto_expandauto_expand_directiondaily_scoring_limitsources
get_persona_settingsScope read
Alle instellingen van een persona, met de zoekopdrachten en concurrentaccounts.
Verplichtpersona_id
update_personaScope write
Wijzigt de instellingen van een persona, of activeert of pauzeert die.
Verplichtpersona_id
Optioneelnamewebsitedescriptionmarketkeywordscompetitorsavoidmin_followersinclude_closed_inboxesauto_expandauto_expand_directiondaily_scoring_limitstatus
delete_personaScope write
Verwijdert een persona met de bronnen en de leads waar geen campagne iets mee deed. De assistent vraagt eerst om bevestiging.
Verplichtpersona_id
reorder_personasScope write
Stelt de volgorde van je persona's in.
Verplichtpersona_ids
suggest_personaScope write
Laat de AI een persona schrijven op basis van een naam en wat je verkoopt.
Verplichtpersona_name
Optioneelwebsitebriefcurrent_descriptioninstruction
get_persona_suggestionScope read
Het laatste personavoorstel, pending, ready met de tekst, of error.
Geen argumenten
get_persona_sharingScope read
Welke X-accounts van de eigenaar een persona delen, en met welke andere accounts die nog gedeeld kan worden.
Verplichtpersona_id
update_persona_sharingScope write
Stelt in welke andere X-accounts van de eigenaar een persona delen. Alleen voor de eigenaar.
Verplichtpersona_idaccount_ids

Bronnen

list_sourcesScope read
De bronnen van een persona met hun statistieken, of één ervan.
Verplichtpersona_id
Optioneelsource_idlimitcursorpaused
add_sourceScope write
Voegt een X-account toe als bron van een persona.
Verplichtpersona_idusername
Optioneelread_followingread_followersscore_self
update_sourceScope write
Wijzigt wat Gemlead van een bron leest, of pauzeert, hervat, vernieuwt of scoort de bron, of slaat hem over.
Verplichtpersona_idsource_id
Optioneelread_followingread_followersscore_selfaction
delete_sourceScope write
Verwijdert een bron en de leads ervan waar geen campagne iets mee deed. De assistent vraagt eerst om bevestiging.
Verplichtpersona_idsource_id
list_source_leadsScope read
De leads die een bron vond, beste score eerst.
Verplichtpersona_idsource_id
Optioneelorderlimitcursor
list_persona_itemsScope read
De zoekopdrachten of concurrentaccounts van een persona, elk met de gevonden, gescoorde en hete leads.
Verplichtpersona_idkind
edit_persona_itemsScope write
Voegt zoekopdrachten of concurrentaccounts toe aan een persona, of verwijdert ze.
Verplichtpersona_idkind
Optioneeladdremove
list_item_leadsScope read
De leads die één zoekopdracht of één concurrentaccount vond, beste score eerst.
Verplichtpersona_id
Optioneelsearch_querycompetitor_accountorderlimitcursor
suggest_sourcesScope read
X-accounts die de AI voorstelt als bronnen voor een persona.
Verplichtpersona_id
lookup_x_profileScope read
Leest een X-profiel live uit, en met een persona erbij ook hoe goed het als bron is.
Verplichtusername
Optioneelpersona

Campagnes

list_campaignsScope read
Je campagnes met hun totalen.
Optioneelstatuspersona_idlimitcursor
get_campaign_statsScope read
De DM's, antwoorden en reactieratio van een campagne over een periode, per dag.
Verplichtcampaign_id
Optioneelfromto
create_campaignScope write
Maakt een conceptcampagne op basis van een template of je eigen flow. Er gaat niets de deur uit tot je hem start.
Verplichtpersona_idname
Optioneelmethodmin_scoredaily_limitlead_ordertemplateflow
get_campaign_settingsScope read
De instellingen en de flow van een campagne, elke stap met zijn ID.
Verplichtcampaign_id
update_campaignScope write
Wijzigt de instellingen van een campagne of vervangt de flow.
Verplichtcampaign_id
Optioneelnamemethodmin_scoredaily_limitlead_orderflow
set_campaign_statusScope write
Start, pauzeert of archiveert een campagne. Bij het starten gaan er likes, reacties, follows en DM's uit vanaf je X-account, dus de assistent vraagt eerst om bevestiging.
Verplichtcampaign_idstatus
duplicate_campaignScope write
Kopieert de instellingen en de flow van een campagne naar een nieuw concept.
Verplichtcampaign_id
delete_campaignScope write
Verwijdert een campagne. De leads en gesprekken blijven bestaan, en de assistent vraagt eerst om bevestiging.
Verplichtcampaign_id
list_campaign_leadsScope read
De leads van een campagne per fase, met wat de campagne bij elke lead heeft geplaatst.
Verplichtcampaign_id
Optioneelstagestep_idbranchskippedqlimitcursor
get_campaign_trendsScope read
De gestarte leads, DM's, antwoorden en follows van een campagne, per dag of per uur.
Verplichtcampaign_id
Optioneelmetricsrangetimezone
list_campaign_templatesScope read
De campagnetemplates met hun volledige flows.
Optioneelmethodmarket

Gesprekken

list_conversationsScope read
Je gesprekken, met het meest recente bericht eerst, of alleen de ongelezen als je daarom vraagt. Met include_messages komt elk gesprek met al zijn berichten.
Optioneelunreadpersona_idinclude_messageslimitcursor
get_conversationScope read
Eén gesprek met al zijn berichten.
Verplichtconversation_id
list_messagesScope read
De volledige geschiedenis van een gesprek vanaf X, pagina per pagina.
Verplichtconversation_id
Optioneellimitcursor
view_mediaScope read
Laat de assistent een afbeelding of GIF van een bericht zien, via de url in de media ervan.
Verplichturl
send_messageScope write
Stuurt een DM vanaf je X-account naar de lead, met tekst, een afbeelding, een GIF, een video of een spraakbericht. De assistent laat je de tekst eerst zien.
Verplichtconversation_id
Optioneeltextmediareply_to_message_id
react_to_messageScope write
Voegt je emoji-reactie toe aan een recent bericht of haalt hem weg.
Verplichtconversation_idmessage_idemoji
Optioneelremove
delete_messageScope write
Verwijdert een recent bericht, voor jou of voor beide kanten. De assistent vraagt eerst om bevestiging.
Verplichtconversation_idmessage_id
Optioneelfor_everyone
update_conversationScope write
Markeert een gesprek als gelezen of ongelezen, verplaatst het naar een kolom van het bord, of zet het vast of maakt het los.
Verplichtconversation_id
Optioneelreadcolumn_idpinned
delete_conversationScope write
Verwijdert een gesprek in Gemlead en in je X-inbox. De assistent vraagt eerst om bevestiging.
Verplichtconversation_id
update_conversation_translationScope write
Zet de vertaling van een gesprek aan of uit, of leest de instellingen ervan.
Verplichtconversation_id
Optioneelenabledshownlanguage
translate_messagesScope write
Vertaalt de recente berichten van een gesprek naar een taal.
Verplichtconversation_id
Optioneelmessage_idslanguage
list_pipeline_columnsScope read
De kolommen van je gesprekkenbord, op volgorde.
Geen argumenten
edit_pipeline_columnsScope write
Maakt de kolommen van je gesprekkenbord, of hernoemt, verwijdert, herschikt of klapt ze in.
Verplichtaction
Optioneelcolumn_idnamecollapsedpositioncolumn_ids

Sam AI

get_sam_settingsScope read
De modus, instructies en bestanden van Sam AI op het X-account, een persona of een gesprek. Bij een gesprek ook de modus die echt geldt, wat Sam AI aan het doen is en het antwoord dat hij klaar heeft staan.
Optioneelconversation_idpersona_id
update_sam_settingsScope write
Wijzigt de modus of instructies van Sam AI op een persona of een gesprek, of zet Sam AI aan of uit en stelt de informatie over je business in op het X-account. Met auto gaan er antwoorden uit vanaf je X-account, dus de assistent vraagt eerst om bevestiging.
Optioneelconversation_idpersona_idmodeinstructionsenabled
edit_sam_filesScope write
Voegt via een URL bestanden toe die Sam AI leest, of verwijdert ze, op het X-account, een persona of een gesprek. De assistent vraagt om bevestiging voordat hij er een verwijdert.
Optioneelconversation_idpersona_idaddremove

Account en meer

get_accountScope read
Het X-account waar de verbinding bij hoort, en het abonnement.
Geen argumenten
get_account_settingsScope read
De inboxsync, de DM-pauze, X Chat en de tijdzone en taal van de eigenaar.
Geen argumenten
update_account_settingsScope write
Wijzigt de inboxsync of de tijdzone, taal of naam van de eigenaar, of leest het X-profiel opnieuw.
Optioneelsync_all_conversationstimezonelanguagefirst_namelast_nameinbox_syncrefresh_x_profile
get_exclusion_listScope read
De X-accounts en domeinen die Gemlead nooit benadert, op het account of op één persona.
Optioneelpersona
edit_exclusion_listScope write
Voegt X-accounts en domeinen toe aan de uitsluitingslijst van het account of van één persona, of verwijdert ze.
Optioneeladdremovepersona
get_analyticsScope read
Een grafiek van je Dashboard voor het account of een persona, of de laatste antwoorden, DM's en hete leads.
Verplichtmetric
Optioneelpersonascalestartendtimezone
create_exportScope read
Start één bestand met je leads, in CSV of JSON Lines, of met al je DM-gesprekken en hun volledige thread, in JSON Lines of Markdown.
Optioneeltypeformatfilters
get_exportScope read
De status, voortgang en downloadlink van een export.
Verplichtexport_id
list_exportsScope read
Je exports, nieuwste eerst, met hun status en link.
Geen argumenten

Team

get_teamScope read
De eigenaar van het X-account, de leden en de uitnodigingen, met hun rollen en onderdelen.
Geen argumenten
edit_teamScope write
Nodigt iemand uit per e-mail, wijzigt de rol of de onderdelen van een lid, verwijdert een lid of trekt een uitnodiging in, of verlaat het team.
Verplichtaction
Optioneelemailrolezonesmember_id

Julien AI

ask_julien_aiScope write
Stelt Julien AI, de assistent van Gemlead, vragen over Gemlead en de gegevens van je account. Met chat_id ga je verder in een chat. Een antwoord dat na 25 seconden nog running is, komt terug met zijn ID, zodat je de tool opnieuw kunt aanroepen met alleen reply_id.
Optioneeltextchat_idreply_id

Argumenten en resultaten

Een tool accepteert de parameters van zijn endpoint, met ID's die naar hun object zijn genoemd, zoals lead_id, persona_id, campaign_id, conversation_id of export_id. Lijsten pagineer je met limit en cursor, zoals in Paginering.
Een tool die meerdere dingen doet, accepteert een action, een kind of een status, zoals lead_action met action ingesteld op rescore, refresh, follow of unfollow.
list_campaigns accepteert status als array van draft, active, paused en archived. get_campaign_stats telt van from tot to, allebei tijden in ISO 8601, standaard is to nu en from 30 dagen daarvoor.
create_export accepteert de filters van search_leads in filters, zonder limit en cursor. Met type op conversations exporteert de tool alle DM-gesprekken met hun volledige thread, en dan gaan persona_id en unread in filters. De tool werkt met een read-sleutel, net als Een export maken.
ask_julien_ai stuurt text naar Julien AI, met chat_id om in een bestaande chat verder te gaan. Een antwoord dat langer dan 25 seconden duurt, komt terug als running met zijn id. Roep de tool dan opnieuw aan met alleen reply_id op die waarde, en hij wacht nog maximaal 25 seconden.
get_conversation en list_messages geven bij elk bericht de media met een url. view_media neemt de url van een afbeelding of GIF en laat de afbeelding zelf aan de assistent zien, zodat die een screenshot kan lezen die een lead heeft gestuurd. send_message verstuurt zelf media met media, een openbare https-url of base64-data met het bijbehorende mime_type.
Een ongeldig argument komt terug als toolfout die dat argument noemt. Een API-fout komt terug als toolfout met de code en het argument waar het om gaat.

Elke tool antwoordt met de JSON van zijn endpoint, als gestructureerde content en als tekst. De tools publiceren geen output-schema, de API-referentie beschrijft elk object.

Met de abonnementen Free en Starter laat de server zich installeren en toont hij zijn tools, maar elke aanroep geeft een fout plan_required die de assistent kan uitleggen. Toolaanroepen tellen mee voor de 120 requests per minuut van de sleutel, gedeeld met de REST API.

Voorbeeldprompts

Laat me de hete leads van vandaag zien voor mijn persona Tipsters, met de reden waarom elke lead hoog scoorde.
Welke campagne had de afgelopen 30 dagen de beste reactieratio, en hoeveel DM's heeft die verstuurd?
Zet mijn ongelezen gesprekken op een rij en vat samen waar elke lead om vraagt.
Exporteer alle hete leads van deze week naar CSV en geef me de link.
Exporteer al mijn DM-gesprekken en vertel me daarna welke openingsberichten de meeste antwoorden krijgen en hoe leads op de prijs reageren.
Markeer de lead @jane_builds als gesloten en sla haar HubSpot-ID hs_48213 op in de metadata.
Zet Sam AI op Semi-automatisch voor mijn persona Tipsters en voeg onze PDF met prijzen toe aan wat hij leest.

Beveiliging

De assistent ziet alleen het X-account dat je hebt gekoppeld.
Trek een verbinding of sleutel op elk moment in via de app, onder API.
Geef een read-sleutel aan een assistent die alleen hoeft te lezen.
Assistenten kunnen worden misleid door tekst die ze lezen. Controleer wat een schrijftool gaat doen voordat je het toestaat.