# CARTO AI Analytics

The **Analytics** tab in Settings > CARTO AI lets organization Admins see how CARTO AI is being used across the organization, both inside CARTO and from external clients consuming CARTO through the MCP Server and the CARTO CLI.

Use it to understand adoption of CARTO AI in your organization, identify your power users, and keep an eye on how much of your contracted AI and agentic usage quotas have been consumed in the current billing cycle.

<figure><img src="/files/2jhIP1ekwwLmGjMlGkNN" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Data is refreshed daily and figures are scoped to your organization. Available to **Admin** users with CARTO AI enabled.
{% endhint %}

{% hint style="warning" %}
Activity for **CARTO Agents** only includes agents created on or after **October 6th, 2026**. Agents created before that date will not appear in the rankings or counts.
{% endhint %}

## Criteria

The Analytics tab is split into three views, each scoping activity to a different source:

* **All activity**: all activity related to CARTO AI, both from agents inside the platform and from external agents.
* **CARTO Agents**: activity from CARTO Builder maps that include an [AI Agent](/carto-user-manual/ai-agents.md).
* **External Agents**: activity from agents outside the CARTO platform, interacting through the [CARTO MCP Server](/carto-for-agents/mcp-server.md) or the [CARTO CLI](/carto-for-agents/cli.md).

## Quotas

The **All activity** view also tracks consumption of your organization's two CARTO AI quotas against the contracted limits for the current billing cycle: the **AI quota** for AI tokens consumed by all CARTO AI features, and the **Usage quota** for agentic usage. Each scorecard shows the percentage of the contracted limit used so far in the current cycle.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.carto.com/carto-user-manual/settings/carto-ai/carto-ai-analytics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
