get_credits

Get credits with Wavegrain's MCP server: the get_credits tool needs the read permission. Inputs, outputs and an example call.

Get credits. Permission: read. Read-only: changes nothing.

The plan, credit balance, this month's slideshow count, and this key's daily cap with what it used in the last 24 hours.

Inputs

No inputs.

The fields inside an object or a list are in the JSON Schema at /developers/mcp-tools.json.

Returns

FieldTypeNotes
planstringThe user's plan key; free when there is no paid plan.
creditsnumberCredits left now.
creditsMaxnumberCredits the plan gives each month.
carouselsThisMonthnumberSlideshows made this calendar month.
carouselsMaxnumberSlideshows the plan allows each month; -1 means no limit.
trialobjectThe user's trial, if any.
tokenobjectThe spend limit of the key or connection that called.

Example call

Send it to POST https://wavegrain.com/api/mcp with an access key that has the read permission; Authentication shows how to make one.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_credits",
    "arguments": {}
  }
}

Something wrong or missing? Write to support@wavegrain.com.