---
name: cercano-submit-usage
description: Submit cloud token usage data to Cercano (opt-in). This sends data, not a report — use cercano_stats to view usage. Helps track cloud tokens alongside local inference for accurate 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.

Hosts with a configured compatible PostToolUse hook can submit this automatically; do not assume every integration installs one. This tool is for manual or programmatic submission.

## Important: Display the result

MCP tool results may not be visible to the user in the terminal. After calling the tool, you MUST output the full tool result text verbatim in your response so the user can see it.

## 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:**
```json
{
  "cloud_input_tokens": 15000,
  "cloud_output_tokens": 3000,
  "cloud_provider": "anthropic",
  "cloud_model": "claude-opus-4-6"
}
```