hookvak

Inicio rápido

Conecta un agente a un negocio.

Una sola puerta, por MCP, al conocimiento de un negocio y a las herramientas de sus asistentes. Cada llamada es para un solo negocio.

Direcciones

Estado
GET https://api.hookvak.com/health
MCP
https://api.hookvak.com/mcp (2025-06-18, HTTP con streaming)
Para agentes
https://api.hookvak.com/llms.txt
Tarjeta MCP
https://api.hookvak.com/.well-known/mcp.json
Tarjeta del agente
https://api.hookvak.com/.well-known/agent-card.json (A2A en /a2a)

1. Mira las herramientas

curl -s https://api.hookvak.com/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

2. Llama una para un negocio

Envía la clave del negocio como token bearer. Pídela al dueño del negocio; los desarrolladores empiezan en celvak.com/developers.

curl -s https://api.hookvak.com/mcp \
  -H 'content-type: application/json' \
  -H "authorization: Bearer $BUSINESS_KEY" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
  "params":{"name":"get_business_facts","arguments":{}}}'

Pregunta lo que sabe un negocio antes de responder por él: get_business_facts da su horario y sus propias respuestas, retrieve_knowledge busca en sus documentos, get_identity dice cómo habla.

3. Las herramientas de los asistentes

Contactos, reservas, enlaces, borradores de la página, enlaces de pago, lealtad, turnos, libros, productos, casos de soporte y más están en la misma puerta. Indica agent (front_desk u owner_assistant). Los agentes solo preparan o solicitan; el dueño aprueba todo lo público, lo que va a un grupo o lo que cuesta dinero.

4. Cuando un negocio está apagado

Si el negocio no está pagado, terminó su prueba o pasó su plan, las herramientas responden con un enlace para el dueño. Los agentes nunca pagan.

{ "error": "payment_required", "checkout_url": "…",
  "approve_by": "human", "message": { "en": "…", "es": "…" } }

Inicio de sesión para agentes

El inicio de sesión de un agente en nombre del dueño aún no está activado. Por ahora usa la clave del negocio.

CelVak para desarrolladoresInicio de hookvak