account_status

Returns the caller's credit balance and key metadata. Does not consume a credit. Free.

Cost: Free  ·  Response shape: jsonb

This is the only tool exempt from credit charges. Use it to confirm authentication, check your remaining credit balance, and inspect key metadata without spending a credit. It makes a reliable health-check call before running a workflow.

Parameters

This tool takes no arguments. The server derives your organisation and key context from your bearer token automatically.

Example invocation

Ask your agent: "What is my current credit balance?"

curl -s https://mcp.precursorintelligence.com \
  -H "Authorization: Bearer $PRECURSOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"account_status","arguments":{}}}'

Response

{
  "organisation_id": "5f9c2a3b-e812-4d7a-b041-2c8d9f0a1e34",
  "key_id": "a1b2c3d4e5f60718",
  "name": "claude-desktop-laptop",
  "ip_scoped": false,
  "created_at": "2026-01-12T11:00:00Z",
  "last_used_at": "2026-05-18T10:24:00Z",
  "last_used_ip": "203.0.113.42",
  "expires_at": null,
  "revoked_at": null,
  "credits": 9998,
  "generated_at": "2026-05-18T10:24:31.118Z"
}

All fields are returned at the top level. credits is the integer count of credits remaining for your organisation. The top-level MCP envelope's _meta.precursor.credits.charged will always be 0 for this tool.

Note: the full MCP envelope structure is documented in Response Format.

Errors

The only failure modes are authentication issues:

No insufficient_credits error can occur here; the tool is free.