---
name: cvm-mcp
description: Skill da REST API do CVM (Valores Mobiliários) na MCP.AI: 1 endpoint em /api/cvm. Consulta o cadastro de uma pessoa física ou jurídica na Comissão de Valores Mobiliários (CVM) a partir do CPF ou CNPJ. Hospedado pela plataforma, sem credenciais, pague por consulta com crédito pré-pago. Autentique com workspace API key (sk_live) gerada em app.mcp.ai/settings/api-keys. Use quando o usuário pedir algo coberto pelos endpoints.
---

# CVM (Valores Mobiliários) — REST API skill

Você tem acesso à **CVM (Valores Mobiliários)** REST API na MCP.AI.

> Consulta o cadastro de uma pessoa física ou jurídica na Comissão de Valores Mobiliários (CVM) a partir do CPF ou CNPJ. Hospedado pela plataforma, sem credenciais, pague por consulta com crédito pré-pago.

## Base URL

```
https://api.mcp.ai/api/cvm
```

Todo endpoint é um **POST** na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

## Autenticação

Inclua em toda request:

```
Authorization: Bearer sk_live_...
Content-Type: application/json
```

> Gere sua chave em **https://app.mcp.ai/settings/api-keys** (workspace API key `sk_live_…`, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

## Formato de resposta

```json
{ "ok": true, "tool": "<tool_id>", "result": <payload> }
```

## Exemplo cURL

```bash
curl -X POST https://api.mcp.ai/api/cvm/consultar \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"CPF":"...","CNPJ":"..."}'
```

## Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): **POST /api/cvm/report** com `{ "message": "...", "context"?: "...", "conversation"?: [...] }`. Isso notifica o time da MCP.AI.

## Endpoints (1)

#### `cvm_consultar`

Consulta o cadastro de uma pessoa física ou jurídica na Comissão de Valores Mobiliários (CVM) a partir do CPF ou CNPJ. _(POST /api/cvm/consultar)_

| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `CPF` | string | Sim | Parâmetro de consulta "CPF". |
| `CNPJ` | string | Sim | Parâmetro de consulta "CNPJ". |
| `completo` | boolean | Não | Opcional. Por padrão (false) listas longas vêm resumidas aos primeiros itens, com a contagem total preservada. Use true para a resposta COMPLETA na mesma consulta. |

---

Este MCP também funciona via **conexão MCP** (Claude / Cursor) em `https://api.mcp.ai/p_cvm` — veja o [README](../../README.md). A skill acima é pra consumir a **REST API** direto (agente próprio / código).