account_balance
Check the authenticated user's current monthly DeepSyte usage, remaining balance, reset date, plan, and quota policy.
Parameters
This MCP tool does not require parameters. It uses the authenticated DeepSyte account from the current MCP or CLI session.
Example
Check my DeepSyte account balance before running this auditResponse
Returns a human-readable balance summary plus JSON with:
| Field | Description |
|---|---|
plan | Current account plan |
isAdmin | Whether the account is configured as an admin |
unit | Usage unit, currently actions |
window.startedAt | Start of the current monthly usage window |
window.resetAt | Reset time for the monthly usage window |
usage.used | Count used in the current month |
usage.limit | Monthly limit, or null for unlimited accounts |
usage.remaining | Remaining monthly balance, or null for unlimited accounts |
usage.unlimited | Whether quota is unlimited |
usage.policy | Applied policy, such as plan-limit, legacy-free-grandfathered, or admin-unlimited |
REST and CLI Equivalents
curl https://api.deepsyte.com/v1/account/balance \
-H "Authorization: Bearer sk_live_..."
deepsyte balance
deepsyte balance --jsonGET /v1/account/usage is an alias for the REST endpoint.
Notes
- Admin accounts listed in
ADMIN_EMAILSreturnusage.unlimited: true,usage.limit: null,usage.remaining: null, andusage.policy: "admin-unlimited". - The endpoint and MCP tool still report
usage.usedfor admin accounts so owners can see activity without being rate-limited.