IA e automação

Conecte seu agente com MCP

Use agentes compatíveis com MCP para consultar os dados autorizados da sua conta.

{ } Referência da API Parâmetros e testes →✧ Para agentes de IA Markdown e OpenAPI →

Configure a conexão

Informe o endpoint HTTPS /mcp e envie X-API-Key no cabeçalho. O servidor usa JSON-RPC 2.0 sobre HTTP. O exemplo representa a configuração de um cliente compatível; confira o formato aceito pelo seu editor ou agente. Guarde a chave no cofre do cliente.

Exemplo

{
  "mcpServers": {
    "antecipafacil": {
      "type": "http",
      "url": "https://api-end.antecipafacil.net.br/mcp",
      "headers": {
        "X-API-Key": "<sua-chave>"
      }
    }
  }
}

Descubra as ferramentas

Inicie a conexão com initialize. Em seguida, use tools/list para obter as ferramentas e seus schemas atuais. As ferramentas publicadas incluem portal.get_identity, portal.get_api_status e portal.api_get. Consulte o resultado real de tools/list antes de chamar uma ferramenta.

Consulte a API pelo agente

portal.api_get recebe service, path e query. service pode ser onboarding, cadastro, leilao, recebivel ou titulo. path deve ser uma rota GET pública documentada do mesmo serviço. A chave precisa de mcp:read e do escopo de leitura do domínio. A chamada mantém os limites e as permissões da conta.

Exemplo

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "portal.api_get",
    "arguments": {
      "service": "onboarding",
      "path": "/v1/onboarding/me",
      "query": {}
    }
  }
}

Mantenha o controle da conta

Use apenas ferramentas de leitura. Não inclua a chave em prompts, mensagens ou documentos. Identifique a conta antes de consultar dados. Nenhuma ferramenta documentada neste corte concede autorização para lance, aceite, aprovação, transferência ou desembolso.