MCP e API para agentes de IA

Conectar via MCP

Configure o endpoint HTTP do Crivo no seu cliente MCP e envie a chave no header X-API-Key. As consultas exigem uma chave da sua conta e uma assinatura elegível.

Exemplo de configuração; os campos podem variar conforme o cliente. Substitua a chave ilustrativa pela sua e mantenha a configuração privada.

{
  "mcpServers": {
    "crivo": {
      "type": "http",
      "url": "https://api.crivo.ai/mcp",
      "headers": {
        "X-API-Key": "crv_live_..."
      }
    }
  }
}

1. Crie uma conta, confirme o plano e obtenha sua chave.
2. Adicione a conexão no cliente MCP e confira as ferramentas anunciadas por tools/list.
3. Peça ao agente para consultar um ativo ou buscar trechos de relatórios. Confira o escopo e as fontes antes de usar a resposta.

Contexto financeiro inteligente

Delimite a companhia, o período e o tipo de documento para recuperar trechos relevantes. Os resultados podem incluir identificadores de evidência, documento e revisão, além de páginas, datas e URL de origem, quando disponíveis.

Seu agente decide quais evidências incluir na conversa e como gerenciar sua memória. Para uma síntese com citações, a ferramenta beta de respostas seleciona e deduplica evidências e informa quando a cobertura é parcial, desatualizada ou insuficiente.

Primeira chamada

Busque um ativo por ticker. Defina CRIVO_API_KEY com sua chave no ambiente do servidor e execute um dos exemplos. JavaScript usa Node.js; Python requer o pacote requests. Não coloque a chave no código do navegador.

curl --fail-with-body -X GET "https://api.crivo.ai/stocks?search=PETR4" \
  -H "X-API-Key: $CRIVO_API_KEY"

// Node.js — execute no servidor
const apiKey = process.env.CRIVO_API_KEY;
if (!apiKey) throw new Error("Defina CRIVO_API_KEY");

const response = await fetch("https://api.crivo.ai/stocks?search=PETR4", {
  method: "GET",
  headers: { "X-API-Key": apiKey }
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

import os
import requests

response = requests.get(
    "https://api.crivo.ai/stocks?search=PETR4",
    headers={"X-API-Key": os.environ["CRIVO_API_KEY"]},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Da resposta ao seu produto

Use os mesmos campos para montar uma lista de ativos ou um cartão de cotação. Este exemplo é estático e não faz chamadas à API.

{
  "pagination": {
    "cache_key": "stocks_example",
    "page": 1,
    "has_next_page": false
  },
  "stocks": [
    {
      "cd_cvm": "9512",
      "ticker": "PETR4",
      "name": "PETROBRAS",
      "variation": {
        "value": "0.67 (+1.77%)",
        "signal": "pos"
      },
      "currency": "BRL",
      "image": "",
      "dividend_yield": "4.35%",
      "price_to_earnings": "8.40",
      "ebitda": "1000000",
      "price_to_book": "1.20",
      "close": "38.44",
      "sector": "Petróleo, Gás e Biocombustíveis"
    }
  ]
}