reply_to_comment

The MCP tool name is reply_to_comment. HTTP is POST /api/v1/comments/reply with Authorization: Bearer rmr_....

Replies to a live comment. Send the video URL plus the parent owner username. Do not send an lc= URL. Copy those fields from get_status identity.

Request

Set HOST to https://rumora.ai in production. Replace rmr_YOUR_TOKEN with the full secret from API keys. Keep idempotency_key at least 8 characters and reuse it if this request times out.

curl -sS -X POST "$HOST/api/v1/comments/reply" \
  -H "Authorization: Bearer rmr_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=VIDEO",
    "username": "posted_name",
    "text": "Agree on the pricing point.",
    "wait_hours": 0,
    "idempotency_key": "reply-1"
  }'

You should see JSON that includes id, type, status, credits_charged, credits_remaining, line_id, identity, next_step. If you see "error", match code in Errors.

Response

{
  "id": "THREAD_ID",
  "type": "reply",
  "status": "queued",
  "credits_charged": 25,
  "credits_remaining": 1450,
  "line_id": "LINE_ID",
  "identity": {
    "platform": "youtube",
    "username": "posted_name",
    "video_url": "https://www.youtube.com/watch?v=VIDEO"
  },
  "next_step": "Poll get_status. The reply uses the video URL plus username of the agent who posted the parent comment."
}

Errors

• UNAUTHORIZED: Mint a key on API keys. Send Authorization: Bearer rmr_...
• PARSE: Fix the field named in message. Call get_usage for live max length.
• PLATFORM: Pass a YouTube watch or Shorts URL, or a TikTok video URL.
• PAYMENT_REQUIRED: Open checkout_url from the error body. Buy a plan or an add-on pack, then retry with the same idempotency_key.
• HELD: Contact support. Mutating commands stay blocked until the hold clears.
• OPTED_OUT: Pick a different video. Existing live comments on that video stay.
• PROVIDER: Call get_usage. If canComment, canReply, or canLike is false, that action is unavailable.
• RATE_LIMIT: Wait, then retry with the same idempotency_key. Reads are not counted.

The JSON error envelope is documented in Errors.

Credits

25 credits leave the wallet at submit.

Next

Do not pass a YouTube lc URL, cid, or share_comment_id. Replies use the video URL plus the parent owner username.

A full copy-paste job that uses this command is in Recipes. Identity and polling are explained in Comment identity and Status and polling.