Skip to content

get_credits

get_credits shows the Muro credit balance and plan of the connected account. Use it before /mcp/tools/visualize-room/ to check that the account can afford the painting. Painting costs 1 credit per colour in standard, 2 in hd and 3 in ultra.

Cost: Free to call, but it needs a Muro API key or an OAuth sign-in on the connection. It is not sold over x402, so an agent paying with x402 cannot use it.

None. Send an empty object.

One text content item:

<credits> credits on the <tier> plan. Painting costs 1 credit per colour in standard, 2 in hd, 3 in ultra. Top up or change plan at https://app.usemuro.com/plan.

Arguments:

{}

Result (illustrative; the values are made up):

20 credits on the free plan. Painting costs 1 credit per colour in standard, 2 in hd, 3 in ultra. Top up or change plan at https://app.usemuro.com/plan.

Without a key (captured from https://mcp.usemuro.com/mcp, isError: true):

Painting a photo needs a Muro account with credits. Create an API key at https://app.usemuro.com/ustawienia (Settings → API keys) and add it to this connection as the header "Authorization: Bearer muro_sk_…". Looking up paint colours stays free without a key.
  • A rejected key (missing, mistyped or revoked) returns an error that says so, followed by the same instructions.
  • Keyed calls fall under the stricter rate limit; see /mcp/overview/.