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.