MapsData

npx add-mcp 'https://mapsdata.ai/mcp'

Conecta un agente de IA

MapsData es un servidor MCP remoto, por lo que un asistente de IA puede crear tus listas de clientes potenciales directamente. Conéctalo una vez y podrás pedirle a Claude u otro agente que encuentre plomeros en Texas, y verificará la categoría, iniciará el raspado y te entregará el archivo cuando termine.

MCP es el Protocolo de Contexto de Modelo, un estándar abierto para darle a un asistente acceso a una herramienta. Nuestro servidor está en:

https://mapsdata.ai/mcp

Incluido en todos los planes de pago, igual que la API REST, y usa las mismas claves de API. Los raspados iniciados por un agente cuentan contra la misma cuota mensual que todo lo demás.

Conexión

La autenticación es un token de portador: tu clave de API de MapsData, creada en Configuración. Consulta autenticación para saber cómo funcionan las claves.

Claude Code

claude mcp add --transport http mapsdata https://mapsdata.ai/mcp \ --header "Authorization: Bearer mdk_live_..."

Cursor

En ~/.cursor/mcp.json, o en el .cursor/mcp.json del proyecto:

{ "mcpServers": { "mapsdata": { "url": "https://mapsdata.ai/mcp", "headers": { "Authorization": "Bearer mdk_live_..." } } } }

Cualquier otra cosa

Cualquier cliente que hable MCP HTTP transmisible y te permita establecer un encabezado funcionará. El servidor no tiene estado: no emite ID de sesión, y cada llamada es un solo POST.

Conectores alojados

Directorios como el de Claude.ai no tienen dónde poner un encabezado, así que usan OAuth en su lugar. MapsData lo admite: registro dinámico de clientes, un flujo de código de autorización con PKCE y tokens de actualización rotativos. Apunta el conector a https://mapsdata.ai/mcp y descubrirá el resto, luego te enviará a una pantalla de consentimiento que nombra la aplicación y declara claramente que aprobarla permite que esa aplicación gaste tu cuota mensual de clientes potenciales.

Las conexiones aprobadas aparecen en Configuración junto a tus claves de API, y desconectar una tiene efecto de inmediato.

Herramientas

Herramienta	Qué hace
mapsdata_search_categories	Encuentra la categoría exacta de Google Maps para raspar
mapsdata_list_regions	Nombres de región válidos para un país
mapsdata_get_usage	Cuota restante en este ciclo y el raspado más grande que puedes iniciar ahora mismo
mapsdata_start_scrape	Inicia un raspado. Admite una ejecución de prueba.
mapsdata_get_scrape	Verifica un raspado
mapsdata_list_scrapes	Raspados recientes, los más nuevos primero
mapsdata_get_download_link	Un enlace de 15 minutos a los resultados
mapsdata_cancel_scrape	Cancela un raspado en cola o en ejecución

Cancelar está marcado como destructivo, por lo que un cliente bien comportado te pedirá confirmación antes de ejecutarlo. Eso es deliberado: cancelar un raspado en ejecución aún factura los clientes potenciales ya entregados.

Un ejemplo práctico

Pide lo que quieras en lenguaje natural:

Find me 500 plumbers in Texas with email addresses.

Un agente bien comportado confirmará que la categoría es raspable, iniciará el trabajo y luego se detendrá en lugar de quedarse en un bucle:

> mapsdata_search_categories(query: "plumb") ["Plumber", "Plumbing supply store"] > mapsdata_start_scrape(query: "Plumber", states: ["Texas"], total_limit: 500) {"job_id": "8f2c...", "status": "queued", "poll_after_seconds": 60, "next_action": "Tell the user the scrape is queued ... then STOP."} "Started a scrape for 500 plumbers in Texas. It usually takes anywhere from a few minutes to a couple of hours. MapsData will email you when it's done, or ask me to check on it."

Más tarde, pídele que verifique y obtenga el archivo:

> mapsdata_get_scrape(job_id: "8f2c...") {"status": "completed", "leads_scraped": 480, "leads_with_email": 151, "next_action": "Call mapsdata_get_download_link."} > mapsdata_get_download_link(job_id: "8f2c...") {"download_url": "https://...", "filename": "Plumber.csv", "expires_in_seconds": 900}

Por qué no se quedará sondeando

Un raspado tarda de minutos a horas, lo cual es una forma incómoda para un asistente. Cada respuesta de trabajo lleva una cifra de poll_after_seconds y una instrucción explícita de next_action que le dice al agente que informe y se detenga. Los agentes siguen un campo en la respuesta de manera mucho más confiable que una descripción, así que ambos están presentes.

Si un agente se queda en bucle de todos modos, los límites de velocidad lo detienen: 120 llamadas por minuto por clave, 300 por minuto en todo tu espacio de trabajo y 10 envíos de raspado por minuto. Un límite perimetral se sitúa delante de todo eso.

Un agente tampoco puede gastar de más tu cuota en una sola llamada. total_limit está limitado a los clientes potenciales que te quedan en este ciclo, y mapsdata_get_usage informa max_rows_this_scrape para que un agente bien comportado dimensione la solicitud antes de hacerla. Cuando un raspado se reduce, la respuesta lo dice y le indica al agente que lo comunique.

Cuando algo sale mal

Los fallos de herramientas vuelven como errores legibles sobre los que el agente puede actuar en lugar de como fallos de protocolo, y nombran la herramienta que soluciona el problema. Pedir una categoría que no existe le dice al agente que llame a mapsdata_search_categories; usar TX en lugar de Texas le dice que llame a mapsdata_list_regions. En la práctica, el agente se corrige solo y reintenta sin involucrarte.

Seguridad

• Tu clave es la cuota de tu espacio de trabajo. Un agente que la tenga puede gastar la cuota del mes. Usa una clave hecha para esto, para que puedas revocarla sin romper nada más.
• Solo lectura si lo prefieres. Elige "Solo lectura" cuando crees la clave en Configuración y el asistente podrá verificar y descargar raspados existentes, pero nunca iniciar ni cancelar uno.
• Cancelar cuesta dinero. Está marcado como destructivo para que tu cliente pregunte primero. Mantén esa confirmación activada.