Developers

MCP · ¿Quiénes se parecen a mi cliente?

Prospección

Listas de empresas por tamaño, rubro, régimen y comuna de su casa matriz, sin escribir un nombre, y cuántas son antes de pedirlas. 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 prospectar_empresas

Prospección de empresas

Empresas por lo que son —tamaño, rubro, régimen y la comuna de su casa matriz—, sin escribir un nombre, en el orden de su RUT. Descuenta una consulta por empresa que no hayas recibido antes en este ciclo: pedir de nuevo una ya recibida no descuenta, y la página vacía descuenta una. Cada plan entrega un máximo de empresas por ciclo, y antes de pedirlas puedes contarlas gratis. Descuenta una consulta por empresa nueva en el ciclo; la que ya recibiste no descuenta, la página vacía descuenta una y el conteo es gratis.

Argumentos

ArgumentoTipoQué es
categoriastringEl tamaño: micro, pequena, mediana, grande, o varios separados por coma. Según el tramo de ventas del año comercial más reciente.
tramo_minimointegerTramo de ventas mínimo, 1 a 13 (el tramo_ventas.codigo).
tramo_maximointegerTramo de ventas máximo, 1 a 13.
trabajadores_minimointegerTrabajadores mínimos del año comercial más reciente.
trabajadores_maximointegerTrabajadores máximos del año comercial más reciente.
rubrostringLa letra de la sección CIIU del rubro (B es minería), o varias separadas por coma.
regimenstringEl régimen tributario: 14A, 14D, 14D8, no14, otros, o varios separados por coma.
actividadintegerCódigo numérico de un giro (el codigo de las actividades).
regionstringLa región de la casa matriz: su código (13) o su nombre («Metropolitana»).
provinciastringLa provincia de la casa matriz: su código (131) o su nombre.
comunastringLa comuna de la casa matriz: su código (13101) o su nombre («Santiago»).
vigentesbooleantrue (por defecto) deja solo las empresas sin término de giro; false las incluye.
creciobooleantrue deja solo las empresas que subieron de tamaño —de micro a pequeña, de pequeña a mediana o de mediana a grande— entre su último año comercial y el anterior, los dos clasificados por el SII; sin el año anterior no cuenta como crecida. false (por defecto) no filtra por eso.
limiteintegerEmpresas por página: 1 a 100. Por defecto 25.
paginastringEl pagina_siguiente de la respuesta anterior. Lleva los filtros adentro: o no los repites, o los repites todos iguales.

Lo que devuelve

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

CampoTipoQué es
filtrosobjectLa pregunta como se leyó: los lugares en código y los tamaños por su nombre.
empresasarrayLas empresas de la página. Vacía si ninguna calza.
nuevasintegerCuántas de la página no habías recibido en este ciclo: las que descontaron.
hay_masbooleantrue si quedan más empresas por pedir.
pagina_siguientestringPásalo tal cual en pagina para pedir la siguiente. null cuando no hay más. Lleva los filtros adentro: no los repitas distintos.
fuentestringDe dónde salen los datos de esta respuesta, en texto listo para citar («Nóminas públicas de contribuyentes y nómina anual de empresas, SII»). Es constante para esta llamada: guárdalo una vez y no lo parsees.
padron_publicadostringQué versión de los datos respondió. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC.
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": "prospectar_empresas",
    "arguments": {
      "categoria": "grande",
      "rubro": "B",
      "comuna": "13101",
      "trabajadores_minimo": 10000
    }
  }
}

El resultado, con su consumo

result · structuredContent + _meta.consumo
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "# Prospección de empresas …"
      }
    ],
    "structuredContent": {
      "filtros": {
        "categoria": [
          "grande"
        ],
        "tramo_minimo": null,
        "tramo_maximo": null,
        "trabajadores_minimo": 10000,
        "trabajadores_maximo": null,
        "rubro": [
          "B"
        ],
        "regimen": [],
        "actividad": null,
        "region": null,
        "provincia": null,
        "comuna": "13101",
        "vigentes": true,
        "crecio": false
      },
      "empresas": [
        {
          "rut": "61704000-K",
          "rut_formateado": "61.704.000-K",
          "razon_social": "CORP NACIONAL DEL COBRE DE CHILE",
          "vigente": true,
          "anio_comercial": 2024,
          "tramo_ventas": {
            "codigo": 13,
            "descripcion": "4to Rango Gran Empresa",
            "desde_uf": 1000000.01,
            "hasta_uf": null,
            "categoria": "Gran empresa"
          },
          "trabajadores": 16946,
          "rubro": {
            "codigo": "B",
            "descripcion": "EXPLOTACION DE MINAS Y CANTERAS"
          },
          "subrubro": "EXTRACCION Y PROCESAMIENTO DE COBRE",
          "regimen": {
            "codigo": "no14",
            "descripcion": "CONTRIBUYENTES NO SUJETOS AL ARTICULO 14"
          },
          "casa_matriz": {
            "comuna": {
              "codigo": "13101",
              "nombre": "Santiago"
            },
            "provincia": {
              "codigo": "131",
              "nombre": "Santiago"
            },
            "region": {
              "codigo": "13",
              "nombre": "Región Metropolitana de Santiago"
            }
          }
        }
      ],
      "nuevas": 1,
      "hay_mas": false,
      "pagina_siguiente": null,
      "fuente": "Nóminas públicas de contribuyentes y nómina anual de empresas, SII",
      "padron_publicado": "2026-08-05T15:36:37+00:00",
      "consultado_en": "2026-08-29T04:12:07+00:00"
    },
    "_meta": {
      "consumo": {
        "consultas_cobradas": 1,
        "plan_restante": 19999,
        "saldo_restante": 0
      }
    }
  }
}

El esquema de los argumentos

inputSchema
{
  "type": "object",
  "properties": {
    "categoria": {
      "type": "string",
      "description": "El tamaño: `micro`, `pequena`, `mediana`, `grande`, o varios separados por coma. Según el tramo de ventas del año comercial más reciente."
    },
    "tramo_minimo": {
      "type": "integer",
      "description": "Tramo de ventas mínimo, 1 a 13 (el `tramo_ventas.codigo`)."
    },
    "tramo_maximo": {
      "type": "integer",
      "description": "Tramo de ventas máximo, 1 a 13."
    },
    "trabajadores_minimo": {
      "type": "integer",
      "description": "Trabajadores mínimos del año comercial más reciente."
    },
    "trabajadores_maximo": {
      "type": "integer",
      "description": "Trabajadores máximos del año comercial más reciente."
    },
    "rubro": {
      "type": "string",
      "description": "La letra de la sección CIIU del rubro (`B` es minería), o varias separadas por coma."
    },
    "regimen": {
      "type": "string",
      "description": "El régimen tributario: `14A`, `14D`, `14D8`, `no14`, `otros`, o varios separados por coma."
    },
    "actividad": {
      "type": "integer",
      "description": "Código numérico de un giro (el `codigo` de las actividades)."
    },
    "region": {
      "type": "string",
      "description": "La región de la casa matriz: su código (`13`) o su nombre («Metropolitana»)."
    },
    "provincia": {
      "type": "string",
      "description": "La provincia de la casa matriz: su código (`131`) o su nombre."
    },
    "comuna": {
      "type": "string",
      "description": "La comuna de la casa matriz: su código (`13101`) o su nombre («Santiago»)."
    },
    "vigentes": {
      "type": "boolean",
      "description": "`true` (por defecto) deja solo las empresas sin término de giro; `false` las incluye."
    },
    "crecio": {
      "type": "boolean",
      "description": "`true` deja solo las empresas que subieron de tamaño —de micro a pequeña, de pequeña a mediana o de mediana a grande— entre su último año comercial y el anterior, los dos clasificados por el SII; sin el año anterior no cuenta como crecida. `false` (por defecto) no filtra por eso."
    },
    "limite": {
      "type": "integer",
      "description": "Empresas por página: 1 a 100. Por defecto 25."
    },
    "pagina": {
      "type": "string",
      "description": "El `pagina_siguiente` de la respuesta anterior. Lleva los filtros adentro: o no los repites, o los repites todos iguales."
    }
  }
}

MCP contar_empresas

Cuántas empresas calzan

Cuántas empresas calzan con los mismos filtros de la prospección y cómo se reparten por tamaño, región y rubro, sin listarlas. No descuenta, y sirve en cualquier plan: es cómo se mide un mercado antes de pedir la lista. Contar no descuenta; la lista descuenta una consulta por empresa nueva en el ciclo; la que ya recibiste no descuenta, la página vacía descuenta una y el conteo es gratis.

Argumentos

ArgumentoTipoQué es
categoriastringEl tamaño: micro, pequena, mediana, grande, o varios separados por coma. Según el tramo de ventas del año comercial más reciente.
tramo_minimointegerTramo de ventas mínimo, 1 a 13 (el tramo_ventas.codigo).
tramo_maximointegerTramo de ventas máximo, 1 a 13.
trabajadores_minimointegerTrabajadores mínimos del año comercial más reciente.
trabajadores_maximointegerTrabajadores máximos del año comercial más reciente.
rubrostringLa letra de la sección CIIU del rubro (B es minería), o varias separadas por coma.
regimenstringEl régimen tributario: 14A, 14D, 14D8, no14, otros, o varios separados por coma.
actividadintegerCódigo numérico de un giro (el codigo de las actividades).
regionstringLa región de la casa matriz: su código (13) o su nombre («Metropolitana»).
provinciastringLa provincia de la casa matriz: su código (131) o su nombre.
comunastringLa comuna de la casa matriz: su código (13101) o su nombre («Santiago»).
vigentesbooleantrue (por defecto) deja solo las empresas sin término de giro; false las incluye.
creciobooleantrue deja solo las empresas que subieron de tamaño —de micro a pequeña, de pequeña a mediana o de mediana a grande— entre su último año comercial y el anterior, los dos clasificados por el SII; sin el año anterior no cuenta como crecida. false (por defecto) no filtra por eso.

Lo que devuelve

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

CampoTipoQué es
filtrosobjectLa pregunta como se leyó, igual que en la prospección.
totalintegerCuántas empresas calzan.
por_categoriaarrayCuántas por tamaño, de micro a grande, y al final las que el SII no estimó. Solo las que tienen empresas.
por_regionarrayCuántas por región de su casa matriz, de norte a sur. Solo las que tienen empresas.
por_rubroarrayCuántas por rubro. Solo los que tienen empresas.
fuentestringDe dónde salen los datos de esta respuesta, en texto listo para citar («Nóminas públicas de contribuyentes y nómina anual de empresas, SII»). Es constante para esta llamada: guárdalo una vez y no lo parsees.
padron_publicadostringQué versión de los datos respondió. ISO 8601 con hora y zona (2026-08-05T15:36:37+00:00), siempre en UTC.
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": "contar_empresas",
    "arguments": {
      "categoria": "grande",
      "rubro": "B",
      "comuna": "13101",
      "trabajadores_minimo": 10000
    }
  }
}

El resultado, con su consumo

result · structuredContent + _meta.consumo
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "# Cuántas empresas calzan …"
      }
    ],
    "structuredContent": {
      "filtros": {
        "categoria": [
          "grande"
        ],
        "tramo_minimo": null,
        "tramo_maximo": null,
        "trabajadores_minimo": 10000,
        "trabajadores_maximo": null,
        "rubro": [
          "B"
        ],
        "regimen": [],
        "actividad": null,
        "region": null,
        "provincia": null,
        "comuna": "13101",
        "vigentes": true,
        "crecio": false
      },
      "total": 1,
      "por_categoria": [
        {
          "categoria": "grande",
          "nombre": "Gran empresa",
          "empresas": 1
        }
      ],
      "por_region": [
        {
          "codigo": "13",
          "nombre": "Región Metropolitana de Santiago",
          "empresas": 1
        }
      ],
      "por_rubro": [
        {
          "codigo": "B",
          "descripcion": "EXPLOTACION DE MINAS Y CANTERAS",
          "empresas": 1
        }
      ],
      "fuente": "Nóminas públicas de contribuyentes y nómina anual de empresas, SII",
      "padron_publicado": "2026-08-05T15:36:37+00:00",
      "consultado_en": "2026-08-29T04:12:07+00:00"
    },
    "_meta": {
      "consumo": {
        "consultas_cobradas": 0,
        "plan_restante": null,
        "saldo_restante": null
      }
    }
  }
}

El esquema de los argumentos

inputSchema
{
  "type": "object",
  "properties": {
    "categoria": {
      "type": "string",
      "description": "El tamaño: `micro`, `pequena`, `mediana`, `grande`, o varios separados por coma. Según el tramo de ventas del año comercial más reciente."
    },
    "tramo_minimo": {
      "type": "integer",
      "description": "Tramo de ventas mínimo, 1 a 13 (el `tramo_ventas.codigo`)."
    },
    "tramo_maximo": {
      "type": "integer",
      "description": "Tramo de ventas máximo, 1 a 13."
    },
    "trabajadores_minimo": {
      "type": "integer",
      "description": "Trabajadores mínimos del año comercial más reciente."
    },
    "trabajadores_maximo": {
      "type": "integer",
      "description": "Trabajadores máximos del año comercial más reciente."
    },
    "rubro": {
      "type": "string",
      "description": "La letra de la sección CIIU del rubro (`B` es minería), o varias separadas por coma."
    },
    "regimen": {
      "type": "string",
      "description": "El régimen tributario: `14A`, `14D`, `14D8`, `no14`, `otros`, o varios separados por coma."
    },
    "actividad": {
      "type": "integer",
      "description": "Código numérico de un giro (el `codigo` de las actividades)."
    },
    "region": {
      "type": "string",
      "description": "La región de la casa matriz: su código (`13`) o su nombre («Metropolitana»)."
    },
    "provincia": {
      "type": "string",
      "description": "La provincia de la casa matriz: su código (`131`) o su nombre."
    },
    "comuna": {
      "type": "string",
      "description": "La comuna de la casa matriz: su código (`13101`) o su nombre («Santiago»)."
    },
    "vigentes": {
      "type": "boolean",
      "description": "`true` (por defecto) deja solo las empresas sin término de giro; `false` las incluye."
    },
    "crecio": {
      "type": "boolean",
      "description": "`true` deja solo las empresas que subieron de tamaño —de micro a pequeña, de pequeña a mediana o de mediana a grande— entre su último año comercial y el anterior, los dos clasificados por el SII; sin el año anterior no cuenta como crecida. `false` (por defecto) no filtra por eso."
    }
  }
}

Probar en la consola Este producto por REST Este producto por SOAP Este producto por GraphQL Qué es Prospección