Developers

MCP · ¿Quién es este RUT?

Consulta de RUT

Razón social, giros con su afectación de IVA, domicilios y la casilla a la que enviarle un documento electrónico. Los ejemplos de abajo son la petición y la respuesta real de cada operación, no una aproximación.

Lo que descuenta cada operación es lo mismo por REST, SOAP, GraphQL y MCP —pagas por el dato, no por el protocolo—; la tabla completa está en Empezar.

MCP consultar_rut

La ficha completa

Todo lo que el padrón sabe del RUT: identidad, giros con su afectación de IVA, domicilios y la casilla a la que enviarle un documento electrónico. Descuenta una consulta por RUT resuelto.

Argumentos

ArgumentoTipoQué es
rut obligatoriostringEl RUT, con o sin puntos y guion (61.704.000-K o 61704000-K).

Lo que devuelve

El mismo cuerpo que GET /v1/rut/{rut}, en structuredContent, y escrito en Markdown en el content de texto; _meta.consumo dice lo que descontó.

CampoTipoQué es
rutstringEl RUT que consultaste, normalizado: con guion y sin puntos.
rut_formateadostringEl mismo RUT listo para mostrar: con puntos y guion.
es_empresabooleantrue si el RUT es de una empresa y false si es de una persona. Sirve para decidir qué pedirle a quien se está registrando.
fuentestringSiempre el mismo texto: de dónde salen estos datos.
padron_publicadostringQué versión de los datos respondió. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC. Cámbiala de zona al mostrarla.
consultado_enstringCuándo se respondió esta llamada. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC.
razon_socialstringEl nombre legal, para imprimir en una factura. Cadena vacía cuando el RUT es de una persona: ahí el nombre hay que pedírselo a ella.
tipo_sociedadstringEn qué familia cae: «PERSONA JURIDICA COMERCIAL», «INSTITUCIONES FISCALES», «ORG. SIN FINES DE LUCRO»… Cadena vacía si no viene clasificada.
subtipo_sociedadstringLa forma exacta dentro de esa familia: «SOCIEDAD POR ACCIONES», «SOC. RESPONSABILIDAD LIMITADA»… Cadena vacía si no viene clasificada.
cod_subtipostringEl código de tres dígitos de ese subtipo («223»). Compara contra ESTE si tu lógica depende del tipo de sociedad: las dos descripciones son texto y pueden cambiar de redacción. Puede llegar con código y con las descripciones vacías.
inicio_actividadesstringDesde cuándo la empresa opera formalmente. ISO 8601 solo fecha (1993-01-01), sin hora ni zona. null en cerca de la mitad de los RUT: no llega para todos.
termino_girostringCuándo la empresa cerró su giro. ISO 8601 solo fecha (1993-01-01), sin hora ni zona. null es el caso normal y quiere decir que no consta un cierre — no confirma que siga operando.
actividadesarrayTodos sus giros. Puede venir vacío.
domiciliosarraySu casa matriz y todas sus sucursales. Puede venir vacío.
casilla_intercambiostringEl correo al que enviarle un DTE. Cadena vacía si no tiene uno registrado: ahí el documento hay que hacérselo llegar por otra vía.
tamanoobjectTamaño y régimen del último año comercial, desde la nómina anual de empresas del SII: tramo de ventas, trabajadores, capital, régimen, rubro y actividad principal. null cuando esa nómina no clasifica al RUT como empresa en los dos últimos años, que es distinto de un campo vacío adentro. Sin costo adicional.
gran_contribuyentebooleantrue si el RUT está en la nómina de Grandes Contribuyentes del SII —el anexo de la resolución que la Dirección de Grandes Contribuyentes dicta cada año; hoy la 208 de 2025—. false para casi todos: son cerca de 4.300 RUT. Sin costo adicional.
grupo_economicointegerEl número de grupo económico con que esa nómina lista al RUT: un entero sin nombre (el SII no publica el nombre del grupo). null cuando no está en la nómina.
tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "consultar_rut",
    "arguments": {
      "rut": "61.704.000-K"
    }
  }
}

El resultado, con su consumo

result · structuredContent + _meta.consumo
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "# La ficha completa …"
      }
    ],
    "structuredContent": {
      "rut": "61704000-K",
      "rut_formateado": "61.704.000-K",
      "es_empresa": true,
      "fuente": "Nóminas públicas de contribuyentes, SII",
      "padron_publicado": "2026-08-05T15:36:37+00:00",
      "consultado_en": "2026-08-29T04:12:07+00:00",
      "razon_social": "CORP NACIONAL DEL COBRE DE CHILE",
      "actividades": [
        {
          "codigo": 40000,
          "descripcion": "EXTRACCION Y PROCESAMIENTO DE COBRE",
          "afecta_iva": true,
          "desde": "1993-01-01"
        },
        {
          "codigo": 351020,
          "descripcion": "TRANSMISION DE ENERGIA ELECTRICA",
          "afecta_iva": true,
          "desde": "2012-11-16"
        }
      ],
      "domicilios": [
        {
          "tipo": "matriz",
          "direccion": "HUERFANOS 1270",
          "calle": "HUERFANOS 1270",
          "numero": "",
          "departamento": "",
          "comuna": "SANTIAGO",
          "ciudad": "",
          "region": "XIII REGION METROPOLITANA",
          "bloque": "",
          "villa": "",
          "vigente_desde": "2007-03-27"
        },
        {
          "tipo": "sucursal",
          "direccion": "AV. LA MONTANA 1550",
          "calle": "AV. LA MONTANA",
          "numero": "1550",
          "departamento": "",
          "comuna": "LAMPA",
          "ciudad": "SANTIAGO",
          "region": "XIII REGION METROPOLITANA",
          "bloque": "",
          "villa": "VALLE GRANDE",
          "vigente_desde": "2012-03-20"
        }
      ],
      "casilla_intercambio": "",
      "tipo_sociedad": "INSTITUCIONES FISCALES",
      "subtipo_sociedad": "ORG. ADMINISTRACION PUBLICA",
      "cod_subtipo": "517",
      "inicio_actividades": "1993-01-01",
      "termino_giro": null,
      "tamano": {
        "anio_comercial": 2024,
        "tramo_ventas": {
          "codigo": 13,
          "descripcion": "4to Rango Gran Empresa",
          "desde_uf": 1000000.01,
          "hasta_uf": null
        },
        "trabajadores": 16946,
        "tramo_capital": null,
        "regimen": {
          "codigo": "no14",
          "descripcion": "CONTRIBUYENTES NO SUJETOS AL ARTICULO 14"
        },
        "renta_presunta": false,
        "rubro": {
          "codigo": "B",
          "descripcion": "EXPLOTACION DE MINAS Y CANTERAS"
        },
        "subrubro": "EXTRACCION Y PROCESAMIENTO DE COBRE",
        "actividad_principal": 40000,
        "primera_inscripcion": "1993-01-01",
        "comuna": "SANTIAGO"
      },
      "gran_contribuyente": true,
      "grupo_economico": 39
    },
    "_meta": {
      "consumo": {
        "consultas_cobradas": 1,
        "plan_restante": 19999,
        "saldo_restante": 0
      }
    }
  }
}

El esquema de los argumentos

inputSchema
{
  "type": "object",
  "properties": {
    "rut": {
      "type": "string",
      "description": "El RUT, con o sin puntos y guion (61.704.000-K o 61704000-K)."
    }
  },
  "required": [
    "rut"
  ]
}

MCP actividades_de

Solo las actividades

Los giros y su afectación de IVA, sin domicilios ni casilla. Útil cuando lo único que necesitas decidir es qué documento tributario corresponde. Descuenta una consulta por RUT resuelto.

Argumentos

ArgumentoTipoQué es
rut obligatoriostringEl RUT, con o sin puntos y guion (61.704.000-K o 61704000-K).

Lo que devuelve

El mismo cuerpo que GET /v1/rut/{rut}/actividades, en structuredContent, y escrito en Markdown en el content de texto; _meta.consumo dice lo que descontó.

CampoTipoQué es
rutstringEl RUT que consultaste, normalizado: con guion y sin puntos.
rut_formateadostringEl mismo RUT listo para mostrar: con puntos y guion.
es_empresabooleantrue si el RUT es de una empresa y false si es de una persona. Sirve para decidir qué pedirle a quien se está registrando.
fuentestringSiempre el mismo texto: de dónde salen estos datos.
padron_publicadostringQué versión de los datos respondió. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC. Cámbiala de zona al mostrarla.
consultado_enstringCuándo se respondió esta llamada. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC.
actividadesarrayTodos sus giros. Puede venir vacío.
tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "actividades_de",
    "arguments": {
      "rut": "61.704.000-K"
    }
  }
}

El resultado, con su consumo

result · structuredContent + _meta.consumo
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "# Solo las actividades …"
      }
    ],
    "structuredContent": {
      "rut": "61704000-K",
      "rut_formateado": "61.704.000-K",
      "es_empresa": true,
      "fuente": "Nóminas públicas de contribuyentes, SII",
      "padron_publicado": "2026-08-05T15:36:37+00:00",
      "consultado_en": "2026-08-29T04:12:07+00:00",
      "actividades": [
        {
          "codigo": 40000,
          "descripcion": "EXTRACCION Y PROCESAMIENTO DE COBRE",
          "afecta_iva": true,
          "desde": "1993-01-01"
        },
        {
          "codigo": 351020,
          "descripcion": "TRANSMISION DE ENERGIA ELECTRICA",
          "afecta_iva": true,
          "desde": "2012-11-16"
        }
      ]
    },
    "_meta": {
      "consumo": {
        "consultas_cobradas": 1,
        "plan_restante": 19999,
        "saldo_restante": 0
      }
    }
  }
}

El esquema de los argumentos

inputSchema
{
  "type": "object",
  "properties": {
    "rut": {
      "type": "string",
      "description": "El RUT, con o sin puntos y guion (61.704.000-K o 61704000-K)."
    }
  },
  "required": [
    "rut"
  ]
}

MCP domicilios_de

Solo los domicilios

Casa matriz y sucursales, con comuna y región. Útil para autocompletar una dirección o para saber dónde opera un proveedor. Descuenta una consulta por RUT resuelto.

Argumentos

ArgumentoTipoQué es
rut obligatoriostringEl RUT, con o sin puntos y guion (61.704.000-K o 61704000-K).

Lo que devuelve

El mismo cuerpo que GET /v1/rut/{rut}/domicilios, en structuredContent, y escrito en Markdown en el content de texto; _meta.consumo dice lo que descontó.

CampoTipoQué es
rutstringEl RUT que consultaste, normalizado: con guion y sin puntos.
rut_formateadostringEl mismo RUT listo para mostrar: con puntos y guion.
es_empresabooleantrue si el RUT es de una empresa y false si es de una persona. Sirve para decidir qué pedirle a quien se está registrando.
fuentestringSiempre el mismo texto: de dónde salen estos datos.
padron_publicadostringQué versión de los datos respondió. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC. Cámbiala de zona al mostrarla.
consultado_enstringCuándo se respondió esta llamada. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC.
domiciliosarraySu casa matriz y todas sus sucursales. Puede venir vacío.
tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "domicilios_de",
    "arguments": {
      "rut": "61.704.000-K"
    }
  }
}

El resultado, con su consumo

result · structuredContent + _meta.consumo
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "# Solo los domicilios …"
      }
    ],
    "structuredContent": {
      "rut": "61704000-K",
      "rut_formateado": "61.704.000-K",
      "es_empresa": true,
      "fuente": "Nóminas públicas de contribuyentes, SII",
      "padron_publicado": "2026-08-05T15:36:37+00:00",
      "consultado_en": "2026-08-29T04:12:07+00:00",
      "domicilios": [
        {
          "tipo": "matriz",
          "direccion": "HUERFANOS 1270",
          "calle": "HUERFANOS 1270",
          "numero": "",
          "departamento": "",
          "comuna": "SANTIAGO",
          "ciudad": "",
          "region": "XIII REGION METROPOLITANA",
          "bloque": "",
          "villa": "",
          "vigente_desde": "2007-03-27"
        },
        {
          "tipo": "sucursal",
          "direccion": "AV. LA MONTANA 1550",
          "calle": "AV. LA MONTANA",
          "numero": "1550",
          "departamento": "",
          "comuna": "LAMPA",
          "ciudad": "SANTIAGO",
          "region": "XIII REGION METROPOLITANA",
          "bloque": "",
          "villa": "VALLE GRANDE",
          "vigente_desde": "2012-03-20"
        }
      ]
    },
    "_meta": {
      "consumo": {
        "consultas_cobradas": 1,
        "plan_restante": 19999,
        "saldo_restante": 0
      }
    }
  }
}

El esquema de los argumentos

inputSchema
{
  "type": "object",
  "properties": {
    "rut": {
      "type": "string",
      "description": "El RUT, con o sin puntos y guion (61.704.000-K o 61704000-K)."
    }
  },
  "required": [
    "rut"
  ]
}

Probar en la consola Este producto por REST Este producto por SOAP Este producto por GraphQL Qué es Consulta de RUT