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

ToolQué haceCréditos
normalizar_direccion Normalizar y geocodificar una dirección argentinaInterpreta 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 municipioDado 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 argentinasBusca 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 oficialBusca 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 municipiosBusca 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 municipios1+

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.

Comprar créditos

Otras APIs de la suite

JSON para agentes: curl https://direcciones-ar-api-103907796853.us-east1.run.app/ · /v1/tools · Privacidad · v0.1.0