> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base39.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar monitoramento

> Ferramenta MCP create_portfolio_item da Base39.

Monitora CPF ou CNPJ nas consultas e frequência escolhidas. Cada ciclo pode debitar o saldo pelas consultas executadas. A criação agenda o primeiro ciclo; pending ainda não comprova consulta concluída. Preço: R\$ 0,00 (gratuito).

## Ferramenta

`create_portfolio_item`

## Exemplo de chamada

```json theme={null}
{
  "method": "tools/call",
  "params": {
    "name": "create_portfolio_item",
    "arguments": {
      "document": "00000000000191",
      "checks": [
        "registration"
      ],
      "frequency": "daily"
    }
  }
}
```

## Exemplo de resultado

```json theme={null}
{
  "document": "00000000000191",
  "checks": [
    "registration"
  ],
  "frequency": "daily",
  "object": "portfolio_item",
  "id": "mon_00000000000000000000000000000001",
  "status": "pending",
  "created_at": "2026-11-10T12:00:00.000Z",
  "next_check_at": "2026-11-10T12:00:00.000Z",
  "last_checked_at": null,
  "last_error": null
}
```

> [accordion] Parâmetros
>
> ```json theme={null}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "type": "object",
>   "properties": {
>     "document": {
>       "type": "string",
>       "pattern": "^(?:\\d{11}|\\d{3}\\.\\d{3}\\.\\d{3}-\\d{2}|[0-9A-Za-z]{12}\\d{2}|[0-9A-Za-z]{2}\\.[0-9A-Za-z]{3}\\.[0-9A-Za-z]{3}\\/[0-9A-Za-z]{4}-\\d{2})$",
>       "description": "CPF ou CNPJ completo a monitorar."
>     },
>     "checks": {
>       "minItems": 1,
>       "maxItems": 12,
>       "type": "array",
>       "items": {
>         "type": "string",
>         "enum": [
>           "registration",
>           "officers",
>           "sanctions",
>           "pep",
>           "lawsuits",
>           "protests",
>           "quod",
>           "serasa",
>           "boavista",
>           "scr",
>           "sites",
>           "reviews"
>         ]
>       },
>       "uniqueItems": true,
>       "description": "Consultas a executar a cada ciclo. Cada consulta usa a tarifa normal e pode debitar o saldo da organização."
>     },
>     "frequency": {
>       "default": "daily",
>       "description": "Frequência das consultas: diária, semanal ou mensal.",
>       "type": "string",
>       "enum": [
>         "daily",
>         "weekly",
>         "monthly"
>       ]
>     }
>   },
>   "required": [
>     "document",
>     "checks"
>   ],
>   "additionalProperties": false,
>   "examples": [
>     {
>       "document": "00000000000191",
>       "checks": [
>         "registration"
>       ],
>       "frequency": "daily"
>     }
>   ]
> }
> ```

> [accordion] Resultado
>
> ```json theme={null}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "type": "object",
>   "properties": {
>     "document": {
>       "type": "string",
>       "pattern": "^(?:\\d{11}|[0-9A-Z]{12}\\d{2})$",
>       "description": "CPF ou CNPJ completo, normalizado e sem pontuação."
>     },
>     "checks": {
>       "minItems": 1,
>       "maxItems": 12,
>       "type": "array",
>       "items": {
>         "type": "string",
>         "enum": [
>           "registration",
>           "officers",
>           "sanctions",
>           "pep",
>           "lawsuits",
>           "protests",
>           "quod",
>           "serasa",
>           "boavista",
>           "scr",
>           "sites",
>           "reviews"
>         ]
>       },
>       "uniqueItems": true,
>       "description": "Consultas a executar a cada ciclo. Cada consulta usa a tarifa normal e pode debitar o saldo da organização."
>     },
>     "frequency": {
>       "default": "daily",
>       "description": "Frequência das consultas: diária, semanal ou mensal.",
>       "type": "string",
>       "enum": [
>         "daily",
>         "weekly",
>         "monthly"
>       ]
>     },
>     "object": {
>       "type": "string",
>       "const": "portfolio_item",
>       "description": "Item monitorado."
>     },
>     "id": {
>       "type": "string",
>       "pattern": "^mon_[a-f0-9]{32}$",
>       "description": "Identificador do item monitorado."
>     },
>     "status": {
>       "type": "string",
>       "enum": [
>         "pending",
>         "active",
>         "failed"
>       ],
>       "description": "Estado do último ciclo de monitoramento."
>     },
>     "created_at": {
>       "type": "string",
>       "format": "date-time",
>       "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
>       "description": "Data de criação."
>     },
>     "next_check_at": {
>       "type": "string",
>       "format": "date-time",
>       "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
>       "description": "Data prevista para a próxima consulta."
>     },
>     "last_checked_at": {
>       "anyOf": [
>         {
>           "type": "string",
>           "format": "date-time",
>           "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
>         },
>         {
>           "type": "null"
>         }
>       ],
>       "description": "Data do último ciclo concluído."
>     },
>     "last_error": {
>       "description": "Código público da última falha; nulo se não houve falha.",
>       "type": [
>         "string",
>         "null"
>       ]
>     }
>   },
>   "required": [
>     "document",
>     "checks",
>     "frequency",
>     "object",
>     "id",
>     "status",
>     "created_at",
>     "next_check_at",
>     "last_checked_at",
>     "last_error"
>   ],
>   "additionalProperties": false,
>   "examples": [
>     {
>       "document": "00000000000191",
>       "checks": [
>         "registration"
>       ],
>       "frequency": "daily",
>       "object": "portfolio_item",
>       "id": "mon_00000000000000000000000000000001",
>       "status": "pending",
>       "created_at": "2026-11-10T12:00:00.000Z",
>       "next_check_at": "2026-11-10T12:00:00.000Z",
>       "last_checked_at": null,
>       "last_error": null
>     }
>   ]
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.