Check Pollinations Balance
pollinations_check_balanceCheck your Pollinations pollen balance or API key budget to avoid failed generations. Use before expensive image/video requests to confirm sufficient credits.
Instructions
Check the authenticated Pollinations pollen balance or API key budget by calling /account/balance. Use this before expensive image/video generation when the user asks about available pollen, credits, budget, or why a generation may be failing with payment/balance errors. Requires POLLINATIONS_API_KEY in the MCP client's env block. Args: - response_format (string, optional, default markdown): markdown for readable balance output, json for raw account/budget response. Returns: The remaining pollen balance or API key budget fields returned by Pollinations. Error handling: 401 means the MCP server is missing POLLINATIONS_API_KEY or the key is invalid. 403 means the key lacks account:usage permission. 402 on generation tools means insufficient pollen, so use this tool to confirm the balance.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "pollinations_check_balance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| response_format | No | MCP response format: markdown for readable balance output, json for raw Pollinations account response. | markdown |