get_status

The MCP tool name is get_status. HTTP is GET /api/v1/status/:id with Authorization: Bearer rmr_....

Poll a handle from a previous write. Replace THREAD_ID with the comment thread id, or with a Find job id. Keep calling until identity is an object, or until Find cards has URLs.

Request

Set HOST to https://rumora.ai in production. Replace rmr_YOUR_TOKEN with the full secret from API keys. Replace THREAD_ID with the id from post_comment, post_thread, or find_videos.

curl -sS "$HOST/api/v1/status/THREAD_ID" \
  -H "Authorization: Bearer rmr_YOUR_TOKEN"

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

Response

{
  "id": "THREAD_ID",
  "type": "thread",
  "status": "live",
  "credits_charged": 25,
  "identity": {
    "platform": "youtube",
    "comment_id": "COMMENT_ID",
    "username": "posted_name",
    "video_url": "https://www.youtube.com/watch?v=VIDEO",
    "youtube_like_url": "https://www.youtube.com/watch?v=VIDEO&lc=COMMENT_ID"
  },
  "next_step": "Like with watch?v= plus lc=COMMENT_ID. Reply with the video URL plus the posted username. Do not send lc on reply."
}

A Find job uses the same route. Poll until cards has URLs, or until "status": "refunded".

{
  "id": "JOB_ID",
  "type": "find",
  "status": "done",
  "credits_charged": 50,
  "step": "done",
  "error": null,
  "cards": [
    {
      "id": "CARD_ID",
      "video_id": "VIDEO_ROW_ID",
      "url": "https://www.youtube.com/watch?v=VIDEO",
      "title": "Example title",
      "skipped": false
    }
  ],
  "next_step": "Pick a video URL from cards and call post_comment or post_thread."
}

Errors

• UNAUTHORIZED: Mint a key on API keys. Send Authorization: Bearer rmr_...
• NOT_FOUND: Check the path and the id from the previous command.

The JSON error envelope is documented in Errors.

Credits

None. This command is read only.

Next

If type is thread and identity is present, like or reply with those fields. If type is find and cards exist, copy a url and call post_comment. If status is refunded, change keywords and start a new Find job.

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