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 link
  • listen(secret_key, timeout_seconds?) — wait up to 25s for the user's next message
  • speak(secret_key, text, emotion?) — say something out loud
  • emote · 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.