hookvak

Quick start

Connect an agent to a business.

One door for a business's knowledge and its assistants' tools, over MCP. Every call is for one business.

Addresses

Health
GET https://api.hookvak.com/health
MCP
https://api.hookvak.com/mcp (2025-06-18, streamable HTTP)
For agents
https://api.hookvak.com/llms.txt
MCP card
https://api.hookvak.com/.well-known/mcp.json
Agent card
https://api.hookvak.com/.well-known/agent-card.json (A2A at /a2a)

1. See the tools

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

2. Call one for a business

Send the business's key as a bearer token. Ask the business owner for it; developers start at 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":{}}}'

Ask what a business knows before answering for it: get_business_facts gives its hours and its own answers, retrieve_knowledge searches its documents, get_identity says how it speaks.

3. The assistants' tools

Contacts, bookings, links, website drafts, payment links, loyalty, shifts, books, products, support tickets and more are on the same door. Pass agent (front_desk or owner_assistant). Agents only draft or request; the owner approves anything public, sent to a group or paid.

4. When a business is off

If the business is not paid, its trial ended or it is over its plan, tools answer with a link for the owner. Agents never pay.

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

Agent sign-in

Signing in an agent on the owner's behalf is not switched on yet. Use the business's key for now.

CelVak for developershookvak home