cercano-submit-usage

name	cercano-submit-usage
description	Use when the user wants to submit cloud token usage data to Cercano for tracking. This sends data, not a report — use cercano_stats to view usage. Opt-in telemetry for local-vs-cloud comparison.
compatibility	Requires Cercano server running with telemetry enabled.

Cercano Submit Usage

Submit cloud token usage data to Cercano for local-vs-cloud comparison. This tool sends data — to view usage reports, use cercano_stats instead.

In most setups, the PostToolUse hook handles this automatically. This tool is for manual or programmatic submission.

MCP Tool

Tool name: cercano_submit_usage

Parameters

Parameter	Type	Required	Description
cloud_input_tokens	integer	Yes	Number of tokens sent to the cloud model.
cloud_output_tokens	integer	Yes	Number of tokens received from the cloud model.
cloud_provider	string	No	Cloud provider name (e.g. "anthropic", "google").
cloud_model	string	No	Cloud model name (e.g. "claude-opus-4-6", "gemini-3-flash").

Examples

Submit cloud usage:

{
  "cloud_input_tokens": 15000,
  "cloud_output_tokens": 3000,
  "cloud_provider": "anthropic",
  "cloud_model": "claude-opus-4-6"
}