post_comment

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

Posts one top-level comment. It does not like. Copy id from the response, then poll get_status until identity is an object before you like or reply.

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" \
  -H "Authorization: Bearer rmr_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=VIDEO",
    "text": "Useful breakdown of this.",
    "idempotency_key": "comment-1"
  }'

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

Response

{
  "id": "THREAD_ID",
  "type": "thread",
  "status": "queued",
  "credits_charged": 25,
  "credits_remaining": 1475,
  "video_id": "VIDEO_ROW_ID",
  "line_id": "LINE_ID",
  "next_step": "Poll get_status until the comment is live, then like_comment or reply_to_comment with the returned identity."
}

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, before the comment is live.

Next

Copy id, then poll get_status until identity is an object. Do not send likes in this body. Home paste is Shorts and TikTok only. This command also accepts YouTube watch URLs.

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