get_usage

The MCP tool name is get_usage. HTTP is GET /api/v1/usage with Authorization: Bearer rmr_....

Call this before every write. It spends nothing. Copy commentMaxLength and likeMin for the platform you will post on, and confirm credits_left covers the next command.

Request

This command has no JSON body. MCP sends an empty arguments object. HTTP sends only the Authorization header.

Set HOST to https://rumora.ai in production. Replace rmr_YOUR_TOKEN with the full secret from API keys.

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

You should see JSON that includes credits_left, checkout_url, find_enabled, comment_credits, like_credits, find_credits, limits. If you see "error", match code in Errors.

Response

{
  "credits_left": 1500,
  "checkout_url": "https://rumora.ai/home/acme/billing",
  "find_enabled": true,
  "comment_credits": 25,
  "like_credits": 1,
  "find_credits": 50,
  "limits": {
    "youtube": {
      "canComment": true,
      "canReply": true,
      "canLike": true,
      "commentMaxLength": 200,
      "replyMaxLength": 200,
      "likeMin": 25,
      "likeMax": 200,
      "minCommentsPerOrder": 1,
      "commentCredits": 25,
      "replyCredits": 25,
      "likeCredits": 1,
      "findCredits": 50
    },
    "tiktok": {
      "canComment": true,
      "canReply": true,
      "canLike": true,
      "commentMaxLength": 200,
      "replyMaxLength": 200,
      "likeMin": 25,
      "likeMax": 200,
      "minCommentsPerOrder": 1,
      "commentCredits": 25,
      "replyCredits": 25,
      "likeCredits": 1,
      "findCredits": 50
    }
  }
}

Errors

• UNAUTHORIZED: Mint a key on API keys. Send Authorization: Bearer rmr_...

The JSON error envelope is documented in Errors.

Credits

None. This command is read only.

Next

Copy commentMaxLength and likeMin for the platform you will post on. Do not hardcode those numbers from an older page. Then call post_comment, post_thread, or find_videos.

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