Quick start
Let an agent message a business's customers.
One MCP door. Every call is for one business, and every message is checked for consent first.
Addresses
- Health
GET https://api.talkvak.com/health- MCP
https://api.talkvak.com/mcp(2025-06-18, streamable HTTP)- For agents
- https://api.talkvak.com/llms.txt
- MCP card
- https://api.talkvak.com/.well-known/mcp.json
1. See the tools
curl -s https://api.talkvak.com/mcp \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
2. Send a text for a business
Send the business's key as a bearer token. Ask the business owner for it; developers start at celvak.com/developers. Use purpose transactional for a reply or a reminder and marketing for a promotion. The same idempotency_key never sends twice.
curl -s https://api.talkvak.com/mcp \
-H 'content-type: application/json' \
-H "authorization: Bearer $BUSINESS_KEY" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"send_text","arguments":{
"to":"+13055550142","text":"Your table is ready.",
"purpose":"transactional","idempotency_key":"order-1042"}}}'
3. The tools
send_textSend a text from the business's line, only if the person agreed to get it.send_whatsappSend a WhatsApp message, only if the person agreed (Pro plan and up).send_emailSend an email, only if the person agreed to get it.deliver_responseAnswer a conversation on its own channel.get_conversationA conversation with its last messages.get_statusWho the caller is, the business's plan and whether it is on.get_usageTexts used against the plan this month.list_plansThe plans and their limits.upgrade_planA payment link for the owner to approve. Agents never pay.make_callCall a customer. Not available yet.
4. When the answer is no
A refusal is a plain code with a message in English and Spanish. Nothing was sent.
consent_requiredThe person has not agreed to this kind of message on this channel. Nothing was sent.opted_outThe person replied STOP. Nothing was sent.outside_windowThe person last wrote more than 24 hours ago, so a reply can't go there now.template_required_outside_sessionOn WhatsApp, after 24 hours only an approved template can go. Send a text instead.compliance_blockedThe message didn't pass the check (for example personal details). Nothing was sent.payment_requiredThe business needs an active plan. The owner approves the link.quota_exceededThe business used all the texts in its plan.calls_not_availableCalls are not available yet.
When a business is off or over its plan:
{ "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.