> ## 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.

# MCP guía

> Utilice Hybridbox a través del punto final y las herramientas Model Context Protocol.

# MCP guía

Hybridbox expone un punto final Model Context Protocol (MCP) para clientes de agente que desean descubrir y llamar pseudofunciones Hybridbox a través del tiempo de ejecución del agente A2A.

El punto final MCP es `/mcp`. Las rutas de origen registran `POST /mcp` para solicitudes MCP JSON-RPC. `GET /mcp` está registrado pero el método de devolución no está permitido, por lo que los clientes deben usar POST para el tráfico MCP.

<Note />

## Superficie de protocolo

Los métodos JSON-RPC admitidos incluyen:

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

Se requieren sesiones autenticadas para `tools/list` y `tools/call`. Las herramientas visibles y las funciones invocables dependen de la sesión autenticada.

## MCP herramientas

### `hybridbox_functions_list`

Enumera Hybridbox pseudofunciones visibles para la sesión autenticada. La herramienta no acepta argumentos.

Utilice esto primero cuando un agente necesite comprender qué funciones están disponibles antes de llamar a algo.

### `hybridbox_functions_explain`

Explica las pseudofunciones visibles de Hybridbox con esquemas, documentación y ejemplos.

Argumentos:

* `function`: nombre de pseudofunción única opcional para explicar.
* `functions`: matriz opcional de nombres de pseudofunciones para explicar.

Úselo antes de la ejecución para que el agente pueda validar nombres, argumentos requeridos, argumentos opcionales y resultados esperados.

### `hybridbox_execute`

Ejecuta pseudofunciones públicas Hybridbox utilizando código pseudo-python a través de la misma ruta de autorización y ejecución que el agente A2A.

Argumentos:

* `code`: cadena requerida que contiene el código de llamada de función pseudo-python Hybridbox, como `domains.list(account_id='acc_123')`.

<Warning>
  Ejecute el código solo después de verificar el esquema de función relevante y validar los argumentos. La ruta de ejecución utiliza el perfil de autorización de la sesión autenticada.
</Warning>

## Flujo de trabajo recomendado

<Steps>
  <Step title="Funciones de lista">
    Llame a `tools/list`, luego llame a `hybridbox_functions_list` para inspeccionar las pseudofunciones disponibles para la sesión autenticada.
  </Step>

  <Step title="Explicar funciones">
    Llame a `hybridbox_functions_explain` con `function` o `functions` antes de la ejecución. Utilice el esquema y los ejemplos devueltos para preparar argumentos válidos.
  </Step>

  <Step title="Ejecutar con argumentos validados.">
    Llame a `hybridbox_execute` con una cadena `code` solo después de que el nombre de la función y los argumentos coincidan con el esquema explicado.
  </Step>
</Steps>

## Catálogo de funciones

El catálogo de funciones A2A generado es la referencia para las pseudofunciones Hybridbox disponibles y sus firmas.

<CardGroup cols={2}>
  <Card title="A2A catálogo de funciones" icon="list" href="/es/agents/a2a-function-catalog">
    Explore firmas de funciones generadas, capacidades y asignaciones de rutas públicas API.
  </Card>

  <Card title="Catálogo de funciones sin formato JSON" icon="code" href="/a2a_functions.v1.json">
    Inspeccione los datos del catálogo `hybridbox.a2a.functions.v1` generados.
  </Card>
</CardGroup>