MCP

Servidor MCP

Pregunta a Claude, ChatGPT o Cursor por tus leads en lenguaje natural. El servidor MCP de Gemlead da a los asistentes de IA los datos y las acciones de la API, con tu permiso.

Qué es

El Model Context Protocol es el estándar abierto que usan los asistentes de IA para llamar a herramientas externas. Conecta Gemlead una vez y tu asistente podrá buscar tus leads calientes, leer y responder tus conversaciones, ver cómo va una campaña o lanzar una exportación, desde el propio chat. Solo ve la cuenta de X que conectas y sigue las reglas de la API, los mismos planes Business y Enterprise y los mismos scopes.

El servidor usa Streamable HTTP. Claude y ChatGPT inician sesión con OAuth, y Cursor y Claude Code pueden enviar una clave API como bearer token.

URL del servidor

https://gemlead.ai/mcp

Configuración

En Claude, abre Customize y luego Connectors.
Haz clic en Add y luego en Add custom connector.
Llámalo Gemlead y pega https://gemlead.ai/mcp como URL del servidor.
Deja Use Claude's published identity como cliente OAuth y haz clic en Add.
Haz clic en Connect, inicia sesión en Gemlead y elige la cuenta de X.

En un chat, activa Gemlead desde el menú +, en Connectors. Claude Desktop y las apps móviles usan los mismos conectores que tu cuenta de Claude, no hay nada más que configurar.

En Team y Enterprise, un propietario añade Gemlead en Organization settings, Connectors, y luego cada miembro hace clic en Connect. El plan Free de Claude permite un conector personalizado.

Otros clientes

Cualquier cliente compatible con Streamable HTTP se conecta igual, con la URL y un encabezado Authorization. Prueba el servidor con el MCP Inspector.

Terminal

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

Varias cuentas de X

Una conexión es para una sola cuenta de X. Para trabajar con varias a la vez, añade Gemlead una vez por cuenta, cada una con su propia URL de servidor, https://gemlead.ai/mcp/ seguido de un nombre que elijas, como https://gemlead.ai/mcp/acme y https://gemlead.ai/mcp/julien. El nombre es solo una etiqueta, con letras, números, - y _.

Conecta cada una y elige su cuenta de X en la página de consentimiento de Gemlead. Si el nombre coincide con el nombre de usuario de X de la cuenta, se elige solo. Si las cuentas están en distintos accesos de Gemlead, inicia sesión con el adecuado antes de conectar.

Cada conexión solo lee y actúa sobre su propia cuenta, e indica al asistente de qué @handle se trata, así que un DM siempre sale de la cuenta que pediste. Ponle a cada conector el nombre de su cuenta, como Gemlead Acme, para distinguirlos en el chat.

Herramientas

El servidor tiene 67 herramientas, una por cada acción de la API. Las de lectura solo leen. Las de escritura modifican datos o actúan en X desde tu cuenta, así que necesitan el scope write, y el asistente te pide confirmación antes de enviar, lanzar o eliminar nada.

Haz clic en la etiqueta MCP de un endpoint en la referencia de la API para ir a su herramienta.

Ninguna herramienta define ni elimina el código de X Chat, por diseño, para que un código nunca pase por un chat de IA. Defínelo en la app o con Definir el código de X Chat.

Leads

search_leadsScope read
Leads con los filtros de Listar leads, como los leads calientes de un buyer persona encontrados esta semana.
Opcionalpersona_idstatusscore_minscore_maxhotscored_afterscored_beforefound_afterfound_beforeorderlimitcursor
get_leadScope read
Un lead con su perfil, su puntuación y su motivo.
Obligatoriolead_id
update_leadScope write
Define metadatos en un lead, o lo cierra cuando terminas con él.
Obligatoriolead_id
Opcionalmetadatastatus
get_lead_originScope read
Cómo encontró Gemlead un lead, la publicación que lo hizo aparecer y sus campañas.
Obligatoriolead_id
lead_actionScope write
Vuelve a puntuar un lead, con un coste de hasta 2 créditos por lead: 1 por la primera pasada y 1 más por la puntuación a fondo si la supera, vuelve a leer su perfil de X, o lo sigue o deja de seguirlo desde tu cuenta de X.
Obligatoriolead_idaction
convert_lead_to_sourceScope write
Convierte un lead en fuente de su buyer persona, para leer a quién sigue, sus seguidores o quién comenta sus publicaciones.
Obligatoriolead_id
Opcionalmethod
delete_leadScope write
Elimina un lead y lo detiene en todas las campañas. El asistente te pide confirmación antes.
Obligatoriolead_id

Personas

list_personasScope read
Tus buyer personas con sus totales y las cifras de hoy.
Opcionallimitcursor
get_personaScope read
Un buyer persona y sus estadísticas.
Obligatoriopersona_id
create_personaScope write
Crea un buyer persona con su descripción, palabras clave, competidores y fuentes iniciales. El scoring usa hasta 2 créditos por lead: 1 por la primera pasada y 1 más por la puntuación a fondo si la supera.
Obligatorionamedescription
Opcionalwebsitemarketkeywordscompetitorsavoidmin_followersinclude_closed_inboxesauto_expandauto_expand_directiondaily_scoring_limitsources
get_persona_settingsScope read
Todos los ajustes de un buyer persona, con sus búsquedas por palabras clave y sus cuentas de competidores.
Obligatoriopersona_id
update_personaScope write
Cambia los ajustes de un buyer persona, o lo activa o lo pausa.
Obligatoriopersona_id
Opcionalnamewebsitedescriptionmarketkeywordscompetitorsavoidmin_followersinclude_closed_inboxesauto_expandauto_expand_directiondaily_scoring_limitstatus
delete_personaScope write
Elimina un buyer persona con sus fuentes y los leads que ninguna campaña trabajó. El asistente te pide confirmación antes.
Obligatoriopersona_id
reorder_personasScope write
Define el orden de tus buyer personas.
Obligatoriopersona_ids
suggest_personaScope write
Pide a la IA que escriba un buyer persona a partir de un nombre y de lo que vendes.
Obligatoriopersona_name
Opcionalwebsitebriefcurrent_descriptioninstruction
get_persona_suggestionScope read
La última sugerencia de buyer persona, pending, ready con su texto, o error.
Sin argumentos
get_persona_sharingScope read
Las cuentas de X del propietario que comparten un buyer persona, y las otras con las que se puede compartir.
Obligatoriopersona_id
update_persona_sharingScope write
Define qué otras cuentas de X del propietario comparten un buyer persona. Solo el propietario.
Obligatoriopersona_idaccount_ids

Fuentes

list_sourcesScope read
Las fuentes de un buyer persona con sus estadísticas, o una de ellas.
Obligatoriopersona_id
Opcionalsource_idlimitcursorpaused
add_sourceScope write
Añade una cuenta de X como fuente de un buyer persona.
Obligatoriopersona_idusername
Opcionalread_followingread_followersscore_self
update_sourceScope write
Cambia lo que Gemlead lee en una fuente, o la pausa, la reanuda, la descarta, la actualiza o la puntúa.
Obligatoriopersona_idsource_id
Opcionalread_followingread_followersscore_selfaction
delete_sourceScope write
Quita una fuente y los leads suyos que ninguna campaña trabajó. El asistente te pide confirmación antes.
Obligatoriopersona_idsource_id
list_source_leadsScope read
Los leads que encontró una fuente, primero los de mejor puntuación.
Obligatoriopersona_idsource_id
Opcionalorderlimitcursor
list_persona_itemsScope read
Las búsquedas por palabras clave o las cuentas de competidores de un buyer persona, cada una con sus leads encontrados, puntuados y calientes.
Obligatoriopersona_idkind
edit_persona_itemsScope write
Añade o quita búsquedas por palabras clave o cuentas de competidores en un buyer persona.
Obligatoriopersona_idkind
Opcionaladdremove
list_item_leadsScope read
Los leads que encontró una búsqueda por palabras clave o una cuenta de competidor, primero los de mejor puntuación.
Obligatoriopersona_id
Opcionalsearch_querycompetitor_accountorderlimitcursor
suggest_sourcesScope read
Cuentas de X que la IA sugiere como fuentes para un buyer persona.
Obligatoriopersona_id
lookup_x_profileScope read
Lee un perfil de X en directo y, con un buyer persona, evalúa si sería una buena fuente.
Obligatoriousername
Opcionalpersona

Campañas

list_campaignsScope read
Tus campañas con sus totales.
Opcionalstatuspersona_idlimitcursor
get_campaign_statsScope read
Los DM, las respuestas y la tasa de respuesta de una campaña en un periodo, día a día.
Obligatoriocampaign_id
Opcionalfromto
create_campaignScope write
Crea una campaña en borrador a partir de una plantilla o de tu propio flujo. No se envía nada hasta que se lance.
Obligatoriopersona_idname
Opcionalmethodmin_scoredaily_limitlead_ordertemplateflow
get_campaign_settingsScope read
Los ajustes de una campaña y su flujo, cada paso con su ID.
Obligatoriocampaign_id
update_campaignScope write
Cambia los ajustes de una campaña o reemplaza su flujo.
Obligatoriocampaign_id
Opcionalnamemethodmin_scoredaily_limitlead_orderflow
set_campaign_statusScope write
Lanza, pausa o archiva una campaña. Al lanzarla se envían me gusta, comentarios, follows y DM desde tu cuenta de X, así que el asistente te pide confirmación antes.
Obligatoriocampaign_idstatus
duplicate_campaignScope write
Copia los ajustes y el flujo de una campaña en un nuevo borrador.
Obligatoriocampaign_id
delete_campaignScope write
Elimina una campaña. Sus leads y conversaciones se conservan, y el asistente te pide confirmación antes.
Obligatoriocampaign_id
list_campaign_leadsScope read
Los leads de una campaña por etapa, con lo que publicó para cada uno.
Obligatoriocampaign_id
Opcionalstagestep_idbranchskippedqlimitcursor
get_campaign_trendsScope read
Los leads iniciados, los DM, las respuestas y los follows de una campaña por día o por hora.
Obligatoriocampaign_id
Opcionalmetricsrangetimezone
list_campaign_templatesScope read
Las plantillas de campaña con sus flujos completos.
Opcionalmethodmarket

Conversaciones

list_conversationsScope read
Tus conversaciones, de la más reciente a la más antigua, o solo las no leídas si lo pides. Con include_messages cada una llega con todos sus mensajes.
Opcionalunreadpersona_idinclude_messageslimitcursor
get_conversationScope read
Una conversación con todos sus mensajes.
Obligatorioconversation_id
list_messagesScope read
Todo el historial de una conversación desde X, página a página.
Obligatorioconversation_id
Opcionallimitcursor
view_mediaScope read
Permite al asistente ver una imagen o un GIF de un mensaje, a partir de la url de su media.
Obligatoriourl
send_messageScope write
Envía un DM desde tu cuenta de X al lead, con texto, una imagen, un GIF, un video o una nota de voz. El asistente te muestra el texto antes.
Obligatorioconversation_id
Opcionaltextmediareply_to_message_id
react_to_messageScope write
Añade o quita tu reacción con emoji en un mensaje reciente.
Obligatorioconversation_idmessage_idemoji
Opcionalremove
delete_messageScope write
Elimina un mensaje reciente, para ti o para los dos. El asistente te pide confirmación antes.
Obligatorioconversation_idmessage_id
Opcionalfor_everyone
update_conversationScope write
Marca una conversación como leída o no leída, la mueve a una columna del tablero, o la fija o la desfija.
Obligatorioconversation_id
Opcionalreadcolumn_idpinned
delete_conversationScope write
Elimina una conversación en Gemlead y en tu inbox de X. El asistente te pide confirmación antes.
Obligatorioconversation_id
update_conversation_translationScope write
Activa o desactiva la traducción de una conversación, o lee sus ajustes.
Obligatorioconversation_id
Opcionalenabledshownlanguage
translate_messagesScope write
Traduce los mensajes recientes de una conversación a un idioma.
Obligatorioconversation_id
Opcionalmessage_idslanguage
list_pipeline_columnsScope read
Las columnas de tu tablero de Conversaciones, en orden.
Sin argumentos
edit_pipeline_columnsScope write
Crea, renombra, contrae, elimina o reordena las columnas de tu tablero de Conversaciones.
Obligatorioaction
Opcionalcolumn_idnamecollapsedpositioncolumn_ids

Sam AI

get_sam_settingsScope read
El modo, las instrucciones y los archivos de Sam AI en la cuenta de X, un buyer persona o una conversación. En una conversación, también el modo que se aplica de verdad, lo que está haciendo Sam AI y la respuesta que tiene lista.
Opcionalconversation_idpersona_id
update_sam_settingsScope write
Cambia el modo o las instrucciones de Sam AI en un buyer persona o una conversación, o lo activa o desactiva y define la información de tu negocio en la cuenta de X. auto envía respuestas desde tu cuenta de X, así que el asistente te pide confirmación antes.
Opcionalconversation_idpersona_idmodeinstructionsenabled
edit_sam_filesScope write
Añade archivos desde una URL o quita archivos que lee Sam AI, en la cuenta de X, un buyer persona o una conversación. El asistente te pide confirmación antes de quitar uno.
Opcionalconversation_idpersona_idaddremove

Cuenta y más

get_accountScope read
La cuenta de X a la que pertenece la conexión, con su plan.
Sin argumentos
get_account_settingsScope read
La sincronización del inbox, la pausa de DM, X Chat y la zona horaria y el idioma del propietario.
Sin argumentos
update_account_settingsScope write
Cambia la sincronización del inbox o la zona horaria, el idioma o el nombre del propietario, o vuelve a leer el perfil de X.
Opcionalsync_all_conversationstimezonelanguagefirst_namelast_nameinbox_syncrefresh_x_profile
get_exclusion_listScope read
Las cuentas de X y los dominios que Gemlead nunca contacta, en la cuenta o en un buyer persona.
Opcionalpersona
edit_exclusion_listScope write
Añade o quita cuentas de X y dominios de la lista de exclusión de la cuenta o de un buyer persona.
Opcionaladdremovepersona
get_analyticsScope read
Un gráfico de tu Panel para la cuenta o un buyer persona, o las últimas respuestas, DM y leads calientes.
Obligatoriometric
Opcionalpersonascalestartendtimezone
create_exportScope read
Lanza una exportación de tus leads en CSV o JSON Lines, o de todas tus conversaciones por DM con su hilo completo, en JSON Lines o Markdown.
Opcionaltypeformatfilters
get_exportScope read
El estado de una exportación, su progreso y su enlace de descarga.
Obligatorioexport_id
list_exportsScope read
Tus exportaciones, primero las más recientes, con su estado y su enlace.
Sin argumentos

Equipo

get_teamScope read
El propietario de la cuenta de X, sus miembros y sus invitaciones, con sus roles y sus zonas.
Sin argumentos
edit_teamScope write
Invita a alguien por email, cambia el rol o las zonas de un miembro, quita a un miembro o cancela una invitación, o sale del equipo.
Obligatorioaction
Opcionalemailrolezonesmember_id

Julien AI

ask_julien_aiScope write
Pregunta a Julien AI, el asistente de Gemlead, sobre Gemlead y los datos de tu cuenta. chat_id permite continuar un chat. Si una respuesta sigue en running tras 25 segundos, vuelve con su ID, para llamar de nuevo solo con reply_id.
Opcionaltextchat_idreply_id

Argumentos y resultados

Una herramienta recibe los parámetros de su endpoint, con los ID nombrados según su objeto, como lead_id, persona_id, campaign_id, conversation_id o export_id. Las listas se paginan con limit y cursor, como en Paginación.
Una herramienta que hace varias cosas recibe un action, un kind o un status, como lead_action con action igual a rescore, refresh, follow o unfollow.
list_campaigns recibe status como un array de draft, active, paused y archived. get_campaign_stats cuenta desde from hasta to, ambos en ISO 8601. Por defecto, to es ahora y from, 30 días antes.
create_export recibe los filtros de search_leads en filters, sin limit ni cursor. Con type en conversations, exporta todas las conversaciones por DM con su hilo completo, y filters recibe persona_id y unread. Funciona con una clave read, igual que Crear una exportación.
ask_julien_ai envía text a Julien AI, con chat_id para continuar un chat. Si la respuesta tarda más de 25 segundos, vuelve como running con su id. Vuelve a llamar a la herramienta solo con reply_id igual a ese valor y esperará hasta 25 segundos más.
get_conversation y list_messages listan los archivos multimedia de cada mensaje con su url. view_media recibe la url de una imagen o un GIF y se la muestra al asistente, que así puede leer una captura que envió un lead. send_message envía una imagen con media, una url https pública o data en base64 con su mime_type.
Un argumento incorrecto devuelve un error de herramienta que lo indica. Un error de la API devuelve un error de herramienta con su código y el argumento afectado.

Cada herramienta responde con el JSON de su endpoint, como contenido estructurado y como texto. Las herramientas no publican esquema de salida, cada objeto se describe en la referencia de la API.

En los planes Free y Starter, el servidor se instala y lista sus herramientas, y cada llamada responde con un error plan_required que el asistente puede explicar. Las llamadas a herramientas cuentan dentro de las 120 solicitudes por minuto de la clave, compartidas con la API REST.

Ejemplos de prompts

Muéstrame los leads calientes de hoy de mi buyer persona Tipsters, con el motivo de la buena puntuación de cada uno.
Qué campaña tuvo la mejor tasa de respuesta en los últimos 30 días, y cuántos DM envió?
Lista mis conversaciones no leídas y resume lo que pide cada lead.
Exporta a CSV todos los leads calientes encontrados esta semana y dame el enlace.
Exporta todas mis conversaciones por DM y dime qué mensajes de apertura consiguen más respuestas y cómo reaccionan los leads al precio.
Marca el lead @jane_builds como cerrado y guarda su ID de HubSpot hs_48213 en sus metadatos.
Pon Sam AI en Semiauto para mi buyer persona Tipsters y añade nuestro PDF de precios a lo que lee.

Seguridad

El asistente solo ve la cuenta de X que conectaste.
Revoca una conexión o una clave en la app, en API, cuando quieras.
Da una clave read a un asistente que solo necesita leer.
Un texto que lee el asistente puede engañarlo. Comprueba lo que va a hacer una herramienta de escritura antes de permitirlo.