Clay a MCP: búsqueda de personas y empresas, funciones de enriquecimiento, consultas de tablas y créditos en cualquier agente de IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Clay, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Clay

Datos GTM de Clay desde cualquier agente de IA: busca en la base de datos de personas y empresas de Clay, ejecuta funciones de enriquecimiento gestionadas por Clay o propias sobre hasta 100 elementos, consulta tablas de Clay en los planes Enterprise, busca ejecuciones de Workflows y revisa el saldo de créditos. Funciona con una clave API personal de Clay; el borrado por privacidad viene desactivado.

Configuración

La configuración lleva unos 2 minutos. Necesitas una cuenta de Clay.

1. En Clay abre API and CLI, pestaña API keys (https://app.clay.com/workspaces/~/api-and-cli?tab=api-keys), y crea una clave. La clave actúa como tu usuario, con tus accesos al workspace.
2. Pégala en CLAY_API_KEY. Se envía en la cabecera clay-api-key.
3. Para funciones propias, abre la función en Clay, luego Details, y activa el acceso API; copia su id t_....
4. Instala el conector y ejecuta clay_get_me: devuelve tu usuario y workspace y confirma la clave. clay_get_credit_balance muestra los créditos que quedan; leer el saldo no cuesta créditos.

Buscar en la base de datos de personas y empresas:

1. clay_get_search_query_reference, una vez por sesión, da los campos consultables de personas y empresas, los operadores y la gramática.
2. clay_create_search inicia una búsqueda con una consulta que empieza por select from people o select from companies, por ejemplo select from companies where people.exists(is_current = true and job_title is_similar_to ("VP Sales")), y devuelve un search_id. No se admiten consultas de recuento ni búsquedas de ofertas de empleo.
3. clay_get_search_results con ese id es un iterador con estado: cada llamada devuelve la página siguiente y la IA vuelve a llamar mientras has_more sea true. Las personas llegan con nombre, ubicación y experiencias coincidentes; las empresas con dominio, sector, tamaño, facturación y URL de LinkedIn.

Los resultados de búsqueda cuentan para los límites de tu plan: en el gratuito, 50 por búsqueda y 100 cada 30 días; en los de pago, 500 por petición. Por encima de un límite Clay responde 402 indicando el límite.

Enriquecer con una función:

1. clay_run_routine ejecuta una función gestionada por Clay, o una propia con acceso API, sobre 1 a 100 elementos: el id de la rutina (function:t_...) y elementos como {"id": "row-1", "inputs": {"domain": "clay.com"}}. El id (como máximo 64 caracteres) es tuyo y vuelve con el resultado. Un webhook_id puede avisar a un webhook de Clay registrado cuando termina la ejecución. Las ejecuciones gastan créditos de Clay, así que la IA te dice antes qué función y cuántos elementos va a lanzar.
2. clay_get_run_results con el routine_run_id: HTTP 202 y status: in_progress mientras se ejecuta, luego 200 con status: complete y data. Los resultados se emparejan con las entradas por id, no por orden; una ejecución completa puede contener elementos fallidos, y finished incluye los fallos. La IA consulta cada pocos segundos, no en un bucle cerrado.
3. clay_get_batch_run_results sigue una ejecución por lotes iniciada desde la CLI de Clay o la API; un lote terminado devuelve result_url con el archivo de resultados.

Tablas (planes Enterprise): clay_query_tables lee filas de tablas conocidas con campos seleccionados, filtros, orden, agrupación y joins; el id de la tabla está en su URL (.../tables/t_...). Cada celda vuelve con un status: success (con value), empty, error (con error) o un estado pendiente (running, queued, retry, rate_limited, awaiting_callback). Un recorrido puede devolver dos veces una fila que cambia mientras se lee, así que la IA elimina duplicados por id.

Workflows (beta): clay_get_runs_query_reference da la gramática de consultas de ejecuciones y luego clay_query_workflow_runs encuentra ejecuciones (una consulta select las devuelve de la más reciente a la más antigua, una consulta count da el número). Las consultas tienen como máximo 2000 caracteres; los datos pueden ir unos segundos por detrás.

Desactivadas al instalar: clay_privacy_delete_people borra personas de Clay Audiences para una solicitud de privacidad, como un borrado RGPD, localizadas por email, slug de LinkedIn (la parte tras /in/, no la URL) o teléfono, de 1 a 100 identificadores por llamada. No se puede deshacer, así que un admin del workspace la activa cuando haga falta; después se ejecuta primero con dry_run: true para contar las coincidencias y el trabajo se sigue con clay_get_privacy_deletion_status, disponible hasta cinco días después de que termine.

Paginación: las colecciones devuelven data y un cursor mientras haya más páginas; la IA devuelve el cursor. Las consultas de tablas devuelven 50 filas por página por defecto (como máximo 100), los resultados de ejecuciones 20 (como máximo 100) y las páginas de búsqueda 20 (como máximo 500 en planes de pago, 50 en gratuito y prueba).

Errores habituales: los errores llevan un message. 401 o 403 indican una clave errónea o falta de acceso, 402 un límite de resultados de búsqueda alcanzado, 404 un id desconocido o una función sin acceso API, 409 o 422 un estado o una entrada no válidos. 429 es el límite de frecuencia del workspace: espera los segundos de Retry-After.

Lo que no hace: la Clay Public API no tiene endpoints para listar tablas o funciones, crear tablas ni escribir filas. Las filas siguen llegando a una tabla por su webhook de entrada, y los ids de funciones y tablas se copian desde la app de Clay.

Requisitos previos: CLAY_API_KEY

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige Clay e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos créditos de Clay nos quedan?"
• "Busca VPs de ventas en empresas de software de Alemania con 50 a 200 empleados y muéstrame los 20 primeros."
• "Ejecuta nuestra función de enriquecimiento de empresas function:t_abc123 sobre estos cinco dominios y muéstrame los resultados cuando termine la ejecución."
• "De la tabla t_0te9i4tZEHwc9hihBXu, muestra las empresas con el dominio relleno, ordenadas por dominio."
• "¿Qué ejecuciones de nuestros Workflows de Clay han fallado en las últimas 24 horas?"

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT