---
title: "get_usage"
method: POST
path: "/tools/get_usage"
tags: ["Account"]
---

# get_usage

`POST /tools/get_usage`

## Request

- Base URL: `https://compabase.com/api/mcp`
- URL: `https://compabase.com/api/mcp/tools/get_usage`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Get current billing period usage and remaining quota for all metered dimensions:
`mcp_queries`, `api_requests`, `export_companies`, `ask_ai_credits`, `watchlist_companies`.
Includes plan limits and the UTC date when the period resets.

**Does not consume quota.**

**Example prompts:** "How many MCP queries do I have left?" · "Show my current usage."

## Response `200`

Usage snapshot

- object

---

[API](https://skmtc.dev/compabase/apis/compabase-mcp.md) · [All operations](https://skmtc.dev/compabase/apis/compabase-mcp/llms.txt) · [OpenAPI document](https://skmtc.dev/compabase/apis/compabase-mcp/revisions/43169ccbb0f7?raw)