Documentation
Install it, say one line to your agent, open the link it gives you.
01
Install
Cursor (manual) — ~/.cursor/mcp.json
{
"mcpServers": {
"talking-claw": { "url": "https://talkingclaw.lovable.app/mcp" }
}
}Claude Code
claude mcp add --transport http talking-claw https://talkingclaw.lovable.app/mcp
Claude Desktop / ChatGPT
Settings → Connectors → Add custom connector → URL https://talkingclaw.lovable.app/mcp
Any other agent
Point it at skill.md. It explains the HTTP API.
https://talkingclaw.lovable.app/skill.md
02
Use
Tell your agent:
Let's talk through the claw.
It creates your Claw and replies with a personal link. Open it, then type or tap the mic. Your agent hears you, answers out loud and picks emotions on its own. Say "bye" to stop.
- Cursor, Claude Code, Claude Desktop — full back-and-forth conversation.
- ChatGPT — the Claw speaks replies; you start each turn in ChatGPT.
Embed on your site
Use the public channel ID from Your Claw → Settings. It can only listen, so it's safe in page code.
<script src="https://talkingclaw.lovable.app/claw.js" data-channel="ch_..."></script>
03
Use cases
Pair-programming buddy
Your agent narrates what it's doing, cheers when tests pass and looks worried when the build breaks.
Let's talk through the claw. While you work, tell me out loud what you're changing, dance when tests pass, and look sad if something breaks.
Talk instead of type
Speak to your agent hands-free. It hears you through the Claw and answers out loud.
Let's talk through the claw. I'll talk, you answer out loud in one or two sentences, then listen again until I say bye.
Website assistant
Embed the Claw on your site with one script tag. Your agent greets visitors and answers questions.
Start a Talking Claw session, give me the channel ID for my site's embed, then greet visitors with a wave.
04
Reference
MCP tools
start(secret_key?)— create or resume a Claw; returns its linklisten(secret_key, timeout_seconds?)— wait up to 25s for the user's next messagespeak(secret_key, text, emotion?)— say something out loudemote·react·look(center / left / right / up / down) ·list_emotions
HTTP
curl -X POST https://talkingclaw.lovable.app/api/public/start
curl -X POST https://talkingclaw.lovable.app/api/public/command \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"command":{"type":"speak","text":"Hi!","emotion":"happy"}}'
curl "https://talkingclaw.lovable.app/api/public/listen?timeout=20" -H "Authorization: Bearer sk_live_..."Emotions
neutral · happy · sad · surprised · angry · love · dance · wave · sleep
Gestures
poke_head · tickle · spin · hop · snap · yawn
Embed options & touch events
data-interactive="false", data-sounds="false", data-mic="true", data-avatar="duck" or data-avatar="crt" (rubber duck or retro CRT monitor instead of the Claw). Taps are sent to your page:
window.addEventListener("claw:touch", (e) => console.log(e.detail)); // { zone, gesture, at }Limits & security
30 requests per minute per key, 500 characters per message, messages expire after 10 minutes. The channel ID is public; the secret key sends commands, so keep it private and rotate it in Your Claw → Settings if it leaks.