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.