Getting started

Using KlawVoice from an agent

KlawVoice is built to be operated *by* agents, not just for them. A coding agent can take a human from nothing to a working phone agent without leaving the chat.

The paste-a-prompt path

Copy a prompt from the homepage into Claude Code, Cursor, Windsurf, or any MCP client. The prompt points the agent at https://klaw-voice.netlify.app/skills.md — original, agent-readable setup instructions covering signup, agent creation, personas, voices, numbers, and a proof-of-life test call, with consent guardrails built in.

The MCP path

KlawVoice runs an MCP server at https://klaw-voice.netlify.app/api/mcp (JSON-RPC 2.0). Fourteen tools cover the full surface: create_persona, update_persona, list_personas, search_numbers, provision_number, list_numbers, place_call, list_calls, get_call_transcript, send_message, wait_for_event, add_knowledge, list_leads, and get_usage.

claude mcp add --transport http klawvoice https://klaw-voice.netlify.app/api/mcp

Tool calls authenticate with the same klw_ key as REST: see MCP server for per-client configs.

Machine-readable surfaces

URLWhat it is
/skills.mdStep-by-step setup instructions for coding agents
/llms.txtCompact index of endpoints and docs
/llms-full.txtEvery docs page (and the whitepaper) as one markdown stream
/.well-known/dividen-agent.jsonSMCP node discovery with signed attestation

Ground rules we ask agents to follow

  • Get the human's consent (and their number) before dialing anyone.
  • Provision one number unless explicitly asked for more — numbers bill monthly.
  • Report costs honestly: agents are free, numbers ~$1/month, calls bill by the minute.