Direcciones AR
Argentine addresses for AI agents: normalize and geocode free-text addresses against the official street map (INDEC/IGN via georef), search localities, streets, provinces and municipalities, and reverse lookup from coordinates. Remote MCP with OAuth or a free trial key.
Hosted MCP Server
npx add-mcp 'https://direcciones-ar-api-103907796853.us-east1.run.app/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
Direcciones AR API
Normalización y geocodificación de direcciones argentinas con datos oficiales (georef, INDEC/IGN).
Para agentes de IA: servidor MCP remoto, REST con OpenAPI y una skill lista para instalar. Se paga por uso con créditos prepagos, sin suscripción.
- Normalizar y geocodificar la dirección de un cliente o de un envío
- Saber en qué provincia, departamento y municipio cae una coordenada
- Autocompletar calles y localidades con el callejero oficial
Guías para desarrolladores, con ejemplos en curl, Python, JavaScript, n8n y Google Sheets: API para normalizar y geocodificar direcciones · API de provincias, localidades y calles
Soluciones por rubro: estudios contables · inmobiliarias · tiendas online
Plantillas para Google Sheets y n8n: usá las APIs sin programar.
Widgets gratis para tu sitio: dólar, feriados, UVA e ICL y calculadora de alquiler.
Herramientas gratis, sin registro: Normalizar una dirección y ver sus coordenadas · Buscar una localidad: provincia y partido · todas
1. Conseguí una key de prueba
Gratis, sin registro: trae 50 créditos. La misma key sirve en las tres APIs de la suite (AR Tools, Índices AR y Direcciones AR), con un solo saldo.
Desde la terminal: curl -X POST https://direcciones-ar-api-103907796853.us-east1.run.app/v1/keys
2. Conectala a tu agente
Claude Code
claude mcp add --transport http direcciones-ar https://direcciones-ar-api-103907796853.us-east1.run.app/mcp --header "Authorization: Bearer ak_..."
Cursor, Windsurf, VS Code y otros clientes MCP (mcp.json)
{
"mcpServers": {
"direcciones-ar": {
"url": "https://direcciones-ar-api-103907796853.us-east1.run.app/mcp",
"headers": {
"Authorization": "Bearer ak_..."
}
}
}
}
OpenClaw / Hermes: clawhub install direcciones-ar o la skill.
REST: OpenAPI (sirve para GPT Actions, n8n, Make, etc.). Ejemplo:
curl -X POST https://direcciones-ar-api-103907796853.us-east1.run.app/v1/tools/normalizar_direccion -H 'Authorization: Bearer ak_...' -H 'content-type: application/json' -d '{"direccion":"Av. Corrientes 1234","provincia":"CABA"}'
Tools y costo por llamada
| Tool | Qué hace | Créditos |
|---|---|---|
normalizar_direccion Normalizar y geocodificar una dirección argentina | Interpreta una dirección escrita a mano ('Av. Corrientes 1234, CABA', 'corrientes y callao', 'San Martín 450 piso 3 Rosario'), la normaliza según el callejero oficial (INDEC/IGN vía georef) y devuelve candidatos con calle, altura, localidad, departamento, provincia y coordenadas lat/lon. Pasá provincia o localidad si las conocés: reduce ambigüedad. Si `cantidad` es 0 la dirección no existe en el callejero oficial; si hay varios candidatos, elegí por localidad o pedí precisión al usuario. | 2 |
ubicacion Geocodificación inversa: lat/lon → provincia, departamento y municipio | Dado un punto (latitud, longitud) devuelve en qué provincia, departamento/partido y municipio de Argentina cae, con ids oficiales INDEC. Si el punto está fuera del país, `en_argentina` es false y los campos vienen null. No devuelve calle ni altura. | 1 |
buscar_localidad Buscar localidades argentinas | Busca localidades (ciudades, pueblos, barrios censales) por nombre aproximado y devuelve provincia, departamento/partido, municipio, categoría y coordenadas del centroide, con ids oficiales INDEC. Útil para desambiguar ('¿qué Rosario?'), completar formularios o resolver la ubicación de un cliente. Filtrá por provincia cuando la conozcas. | 1 |
buscar_calle Buscar calles en el callejero oficial | Busca calles por nombre aproximado y devuelve nombre oficial, categoría (CALLE, AV, PJE, RUTA...), rango de alturas y a qué localidad/departamento/provincia pertenece cada tramo. Sirve para validar que una calle existe y que una altura está dentro del rango antes de normalizar, o para autocompletar. | 1 |
buscar_division Buscar provincias, departamentos o municipios | Busca divisiones administrativas oficiales por nombre aproximado: provincias (24), departamentos/partidos/comunas o municipios. Devuelve id INDEC, nombre oficial, provincia a la que pertenece y centroide. Usala para resolver 'Bs As' → 'Buenos Aires' (id 06) vs 'CABA' (id 02), listar los partidos de una provincia, o conseguir el id que piden otros sistemas. | 1 |
ejecutar Ejecutar código contra la API (Code Mode) | Corre JavaScript en un sandbox con un objeto `api` ya autenticado: una función async por tool, mismos parámetros y mismo resultado que llamarla directo. Ideal para lotes (validar 50 CBUs, armar 20 cronogramas) o para encadenar llamadas sin volver al modelo. El código puede usar await, console.log y return; el valor retornado vuelve en `resultado`. Costo: 1 crédito por ejecución + la suma de las llamadas internas. Máximo 100 llamadas y 15 s. Sin acceso a red, archivos ni módulos. Funciones disponibles: api.normalizarDireccion({"direccion":"Av. Corrientes 1234","provincia":"CABA"}) → 2 crédito(s): Normalizar y geocodificar una dirección argentina api.ubicacion({"lat":-34.6037,"lon":-58.3816}) → 1 crédito(s): Geocodificación inversa: lat/lon → provincia, departamento y municipio api.buscarLocalidad({"nombre":"Rosario","provincia":"Santa Fe"}) → 1 crédito(s): Buscar localidades argentinas api.buscarCalle({"nombre":"Santa Fe","provincia":"CABA","categoria":"AV"}) → 1 crédito(s): Buscar calles en el callejero oficial api.buscarDivision({"tipo":"provincia","nombre":"cordoba"}) → 1 crédito(s): Buscar provincias, departamentos o municipios | 1+ |
Solo se cobran las llamadas exitosas. ejecutar corre JavaScript que combina varias tools en una sola llamada: 1 crédito más lo que use.
Precios
Packs de créditos en USD, pago único con tarjeta vía Polar.
Otras APIs de la suite
- AR Tools: Validaciones y datos argentinos: CUIT/CUIL, CBU/CVU, teléfonos, cotización del dólar, aguinaldo y monotributo. Calculadora de aguinaldo (SAC). Calculadora de monotributo: categoría y cuota. Dólar hoy: blue, oficial, MEP y CCL. Validar CUIT o CUIL online. Validar CBU o CVU y ver de qué banco es. Pasar un teléfono argentino al formato de WhatsApp.
- Índices AR: Índices económicos argentinos y ajustes de montos: UVA, CER, ICL, inflación IPC, dólar histórico y días hábiles. Calculadora de aumento de alquiler (ICL, IPC, UVA). Aumento de alquiler de este mes por ICL e IPC. Inflación mensual: último dato del INDEC. Calculadora de inflación: actualizar un monto por IPC. Calculadora de días hábiles con feriados. Convertir pesos a UVA y UVA a pesos. Valor de la UVA, el ICL y el CER hoy. Dólar histórico: cotización en una fecha. Feriados del año en Argentina. Feriados 2027 en Argentina.
JSON para agentes: curl https://direcciones-ar-api-103907796853.us-east1.run.app/ · /v1/tools · Privacidad · v0.1.0