Account

get_plan_usage

The workspace's plan and this month's usage: AI answers analyzed, content credits, and plan limits.

readReads only. Annotated read-only, so a client can call it without asking.

Plan: Grow and above
Rate cost: 1 unit
REST: GET /plan

Try asking

“How many content credits do we have left this month?”

get_plan_usage

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

structuredContent

{
  "content": [
    {
      "type": "text",
      "text": "…the same JSON, as text…"
    }
  ],
  "structuredContent": {
    "plan": "grow",
    "plan_name": "Grow",
    "monthly_price_inr": 18999,
    "engines": 3,
    "sweep_interval_days": 2,
    "billing_scope": "organization",
    "answers": {
      "used": 640,
      "quota": 1800,
      "remaining": 1160
    },
    "drafts": {
      "used": 12,
      "quota": 80,
      "remaining": 68
    },
    "max_prompts": 40,
    "projects": 3,
    "max_seats": 10,
    "max_competitors": 25,
    "monthly_audits": 1000,
    "reports_per_month": 100,
    "max_api_keys": 1,
    "retention_days": 545
  },
  "isError": false
}

Arguments

—none

This tool takes no arguments.

Result

The same object as Get plan and usage, returned as structured output.

planstring

Plan key.

Values:solotrackgrowscalecustom

plan_namestring

Plan name as shown on the dashboard, e.g. Grow.

monthly_price_inrnumber

The plan's monthly price in rupees, before GST.

enginesinteger

AI engines measured on every sweep.

sweep_interval_daysinteger

Days between sweeps: 1 is daily, 2 alternate days, 7 weekly.

billing_scopestring

Where the plan is bought. account means several workspaces share one plan, and the limits and meters below are pooled across them.

Values:accountorganization

answersobject

AI answers analyzed — the plan's billing unit.

+Show child attributes

usedinteger

Answers used this calendar month (UTC).

quotaintegernullable

The monthly allowance. Null means unlimited.

remainingintegernullable

What's left this month. Null when the quota is unlimited.

draftsobject

Content credits. One draft spends one credit.

+Show child attributes

usedinteger

Credits used this calendar month (UTC).

quotaintegernullable

The monthly allowance. Null means unlimited.

remainingintegernullable

What's left this month. Null when the quota is unlimited.

max_promptsintegernullable

Tracked prompts allowed. Null means unlimited.

projectsintegernullable

Projects (brands) allowed. Null means unlimited.

max_seatsintegernullable

Members allowed. Null means unlimited.

max_competitorsintegernullable

Tracked competitors allowed. Null means unlimited.

monthly_auditsintegernullable

Site audits a month. Null means unlimited.

reports_per_monthintegernullable

Reports a month. Null means unlimited.

max_api_keysintegernullable

Active API keys allowed: 1 on Grow, 2 on Scale, 10 on Custom.

retention_daysintegernullable

Days of history the plan keeps visible. Older results are hidden, not deleted. Null means unlimited.

Errors

401 unauthorized	No key was sent, or the key is unknown, revoked or expired, or the member who created it has left the workspace or been deactivated.
402 plan_required	The workspace's plan doesn't include API access. It's included on Grow, Scale and Custom.
403 workspace_not_approved	The workspace is still waiting for approval, or wasn't approved.
429 rate_limited	Too many requests this minute. Wait for the number of seconds in the `Retry-After` header, then retry.

Every code, and what to retry, is in Errors.

Failures arrive as a tool error — isError: true with code: message as text. See Using the tools.