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

# Guia MCP

> Use o Hybridbox por meio do endpoint e das ferramentas do Model Context Protocol.

# Guia MCP

O Hybridbox expõe um endpoint do Model Context Protocol (MCP) para clientes do agente que desejam descobrir e chamar pseudofunções do Hybridbox por meio do tempo de execução do agente A2A.

O terminal MCP é `/mcp`. As rotas de origem registram `POST /mcp` para solicitações MCP JSON-RPC. `GET /mcp` está registrado, mas o método de retorno não é permitido, portanto, os clientes devem usar POST para tráfego MCP.

<Note />

## Superfície do protocolo

Os métodos JSON-RPC suportados incluem:

-`initialize`
-`ping`
-`notifications/initialized`
-`tools/list`
-`tools/call`

Sessões autenticadas são necessárias para `tools/list` e `tools/call`. As ferramentas visíveis e funções que podem ser chamadas dependem da sessão autenticada.

## Ferramentas MCP

### `Hybridbox_functions_list`

Lista pseudofunções do Hybridbox visíveis para a sessão autenticada. A ferramenta não aceita argumentos.

Use isto primeiro quando um agente precisar entender quais funções estão disponíveis antes de chamar qualquer coisa.

\###`Hybridbox_functions_explain`

Explica pseudofunções visíveis do Hybridbox com esquemas, documentação e exemplos.

Argumentos:

* `function`: nome de pseudofunção único opcional a ser explicado.
* `functions`: array opcional de nomes de pseudofunções a serem explicados.

Use-o antes da execução para que o agente possa validar nomes, argumentos obrigatórios, argumentos opcionais e resultados esperados.

\###`Hybridbox_execute`

Executa pseudofunções públicas do Hybridbox usando código pseudo-python por meio da mesma autorização e caminho de execução do agente A2A.

Argumentos:

* `code`: string obrigatória contendo código de chamada de função pseudo-python Hybridbox, como `domains.list(account_id='acc_123')`.

<Warning>
  Execute o código somente após verificar o esquema da função relevante e validar os argumentos. O caminho de execução utiliza o perfil de autorização da sessão autenticada.
</Warning>

## Fluxo de trabalho recomendado

<Steps>
  <Step title="List functions">
    Chame `tools/list` e, em seguida, chame `Hybridbox_functions_list` para inspecionar as pseudofunções disponíveis para a sessão autenticada.
  </Step>

  <Step title="Explain functions">
    Chame `Hybridbox_functions_explain` com `function` ou `functions` antes da execução. Use o esquema e os exemplos retornados para preparar argumentos válidos.
  </Step>

  <Step title="Execute with validated arguments">
    Chame `Hybridbox_execute` com uma sequência `code` somente depois que o nome da função e os argumentos corresponderem ao esquema explicado.
  </Step>
</Steps>

## Catálogo de funções

O catálogo de funções A2A gerado é a referência para pseudofunções disponíveis do Hybridbox e suas assinaturas.

<CardGroup cols={2}>
  <Card title="A2A function catalog" icon="list" href="/pt-br/agents/a2a-function-catalog">
    Procure assinaturas de funções geradas, recursos e mapeamentos de rotas de API públicas.
  </Card>

  <Card title="Raw function catalog JSON" icon="code" href="/a2a_functions.v1.json">
    Inspecione os dados do catálogo `Hybridbox.A2A.functions.v1` gerados.
  </Card>
</CardGroup>