Usage & Plans
Monthly credit quotas, weighted tool costs, and upgrading your plan.
How quota works
ToolYour enforces limits per account, not per API key:
| Concept | Behavior |
|---|---|
| Billing period | Calendar month (resets on the 1st) |
| Monthly allowance | Shared credits for your entire account |
| Weighted tools | Each successful call costs 1–10 credits depending on the tool |
| All API keys | Every successful tool call counts toward the same allowance |
| Per-key stats | Dashboard shows calls per key for visibility only |
Creating multiple keys does not multiply your quota. Use separate keys for environments (dev/staging/prod), not to increase limits.
Browser tools (no API key) do not consume credits.
Credit weights
| Tier | Typical tools | Credits / call |
|---|---|---|
| Light | Text utilities, calculators, simple transforms | 1 |
| Medium | Most SEO analyzers | 3 |
| Heavy | Page speed, bulk SEO, crawl-heavy jobs | 5 |
| Compute | File converters, image compress, PDF↔DOCX | 10 |
Plans
| Plan | Credits / month | Rate limit (Free) | Price |
|---|---|---|---|
| Free | 500 | 5 requests / rolling minute | $0 |
| Pro | 20,000 | Higher throughput | $10 / mo |
| Business | 100,000 | Highest throughput | $21 / mo |
View current pricing and subscribe from Dashboard → Billing on toolyour.com.
What counts as usage
Only successful tool API calls (REST or MCP solve_task execution / invoke_tool / workflow steps) consume credits. Failed requests (4xx validation errors) generally do not.
| Channel | Billable | Free |
|---|---|---|
| REST API | Successful tool calls (weighted) | — |
| MCP | solve_task (when a tool runs), invoke_tool, run_workflow steps | solve_task suggestions only, discover_tools, list_categories, get_tool_schema, list_skills, load_skill |
MCP usage appears in the dashboard usage breakdown. Same credit pool as REST.
Platform actions — login, creating keys, viewing the dashboard — do not consume tool credits.
When you hit the limit
Tool endpoints return 429 Too Many Requests with a monthly quota or rate-limit message. Options:
- Wait until the next billing month
- Upgrade your plan from the dashboard
- Prefer lighter tools or cache results where possible
Track usage
See Dashboard → Overview and Dashboard → API Keys for current-period usage and remaining credits. There is no need to call separate usage APIs from your integration — the dashboard is the source of truth for billing.