Developers

MCP · ¿Quién está detrás?

Sociedades y grupos

En qué sociedades participa un RUT, quiénes participan en él y el grupo que se arma siguiendo esas participaciones. 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 sociedades_de

Sociedades y socios

En qué sociedades participa el RUT y con cuánto, qué personas jurídicas participan en él, y cuánto suman sus personas naturales — sin nombrarlas: el SII publica el porcentaje agregado, no quiénes son. Las listas vacías también son respuesta: «no tiene» es información. Descuenta dos consultas por RUT: sus participaciones y sus socios.

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}/sociedades, 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.
participacionesarrayLas sociedades en que ESTE RUT participa. Vacía si no participa en ninguna.
sociosarrayLas personas jurídicas que participan en él. Vacía si ninguna lo hace — una sociedad de personas naturales, o una empresa del Estado.
personas_naturalesobjectEl agregado de sus socios personas naturales: solo el porcentaje, sin nombres ni RUT, porque es lo único que el SII publica de ellos. null cuando el RUT no tiene socios personas naturales.
fuentestringDe dónde salen los datos de esta respuesta, en texto listo para citar («Composición de sociedades, SII»). Es constante para esta llamada: guárdalo una vez y no lo parsees.
publicadostringDe cuándo es la composición de sociedades que respondió. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC. Es otro archivo que el padrón: otra fecha que padron_publicado.
consultado_enstringCuándo se respondió esta llamada. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC.
tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "sociedades_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": "# Sociedades y socios …"
      }
    ],
    "structuredContent": {
      "rut": "61704000-K",
      "rut_formateado": "61.704.000-K",
      "es_empresa": true,
      "participaciones": [
        {
          "rut": "76028880-2",
          "rut_formateado": "76.028.880-2",
          "razon_social": "SOCIEDAD CONTRACTUAL MINERA PUREN",
          "participacion": 35.0
        },
        {
          "rut": "76148338-2",
          "rut_formateado": "76.148.338-2",
          "razon_social": "SOCIEDAD DE PROCESAMIENTO DE MOLIBDENO SPA",
          "participacion": 100.0
        }
      ],
      "socios": [],
      "personas_naturales": null,
      "fuente": "Composición de sociedades, SII",
      "publicado": "2025-11-25T16:11:42+00:00",
      "consultado_en": "2026-08-29T04:12:07+00:00"
    },
    "_meta": {
      "consumo": {
        "consultas_cobradas": 2,
        "plan_restante": 19998,
        "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 grupos_de

El grupo

Las empresas que se alcanzan siguiendo las participaciones desde el RUT —en las dos direcciones— hasta saltos de distancia, y las participaciones entre ellas. El grupo se corta en 200 empresas y lo dice. Descuenta cinco consultas por RUT: el grupo hasta 3 saltos.

Argumentos

ArgumentoTipoQué es
rut obligatoriostringEl RUT, con o sin puntos y guion (61.704.000-K o 61704000-K).
saltosintegerHasta cuántos saltos seguir las participaciones: 1 a 3. Por defecto 2. Uno es participación directa; cada salto más multiplica las empresas.

Lo que devuelve

El mismo cuerpo que GET /v1/rut/{rut}/grupos, 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.
saltosintegerHasta cuántos saltos se siguió: el que pediste, o 2.
empresasarrayLas empresas del grupo, de la más cercana a la más lejana. Vacía si el RUT no participa en nada ni nadie participa en él.
participacionesarrayLas participaciones ENTRE las empresas de la respuesta (el RUT incluido): el grafo que la lista describe.
truncadobooleantrue si el grupo tiene más de 200 empresas y la respuesta trae solo las más cercanas. Con menos saltos se ve más de cerca.
fuentestringDe dónde salen los datos de esta respuesta, en texto listo para citar («Composición de sociedades, SII»). Es constante para esta llamada: guárdalo una vez y no lo parsees.
publicadostringDe cuándo es la composición de sociedades que respondió. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC. Es otro archivo que el padrón: otra fecha que padron_publicado.
consultado_enstringCuándo se respondió esta llamada. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC.
tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "grupos_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": "# El grupo …"
      }
    ],
    "structuredContent": {
      "rut": "61704000-K",
      "rut_formateado": "61.704.000-K",
      "es_empresa": true,
      "saltos": 2,
      "empresas": [
        {
          "rut": "76063022-5",
          "rut_formateado": "76.063.022-5",
          "razon_social": "INCA DE ORO S.A.",
          "distancia": 1
        },
        {
          "rut": "76092641-8",
          "rut_formateado": "76.092.641-8",
          "razon_social": "PANAUST MINERA IDO LIMITADA",
          "distancia": 2
        }
      ],
      "participaciones": [
        {
          "socio": "61704000-K",
          "sociedad": "76063022-5",
          "participacion": 30.6
        },
        {
          "socio": "76092641-8",
          "sociedad": "76063022-5",
          "participacion": 69.4
        }
      ],
      "truncado": true,
      "fuente": "Composición de sociedades, SII",
      "publicado": "2025-11-25T16:11:42+00:00",
      "consultado_en": "2026-08-29T04:12:07+00:00"
    },
    "_meta": {
      "consumo": {
        "consultas_cobradas": 5,
        "plan_restante": 19995,
        "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)."
    },
    "saltos": {
      "type": "integer",
      "description": "Hasta cuántos saltos seguir las participaciones: 1 a 3. Por defecto 2. Uno es participación directa; cada salto más multiplica las empresas."
    }
  },
  "required": [
    "rut"
  ]
}

Probar en la consola Este producto por REST Este producto por SOAP Este producto por GraphQL Qué es Sociedades y grupos