Togai MCP. Manage Usage, Billing, and Entitlements in Conversation

Togai handles all usage-based billing right through your AI agent. Your agent ingests raw event data, manages customer accounts, defines complex pricing models using rate cards, and instantly checks entitlements—all without leaving the chat window.

Tracking Usage Events. You can send single use events using ingest_event, or you'll process large volumes of usage data at once with ingest_batch_events. To pull aggregated metrics for reporting across specific time ranges, your agent calls get_metrics.

Setting Up Customers and Accounts. When a new client comes in, you can use create_customer to set up their legal entity record. You'll establish the dedicated billing side of things by running create_account, and if those details change later, your agent uses update_account. To keep the customer profile current without touching billing details, it runs update_customer.

If you need a full picture of all accounts managed in the system, call list_accounts; to see every registered client, use list_customers.

Defining Billing Logic and Pricing. To make sure raw usage data translates into actual dollars, your agent first creates how that aggregation must happen by calling create_usage_meter. This tool requires you to specify the event type and computation rules for billable units. Next, you define what those billable units cost using create_price_plan, which sets up a whole pricing structure (V2).

For review, your agent can pull every defined rate card tied to a price plan by calling list_rate_cards. If you need specific financial details for an existing account, you'll use get_account; to check the basic profile and metadata of any customer, run get_customer.

Controlling Access and Features. Your agent checks if a user can access a feature by calling check_entitlement, which verifies access based on their current plan. For a complete view of all usage limits and feature rights tied to an account, you'll use get_entitlements. If the client needs more credits in their wallet, your agent manually adds them using grant_credit; they can also check how much credit is available right now by calling get_wallet_balance.

Auditing and Reviewing Finances. To see a full history of charges, your agent pulls a paginated list of generated invoices using list_invoices, allowing you to filter that data by date or status. If you need all the current financial details for an account, you'll use get_account. You can pull detailed usage metrics across timeframes with get_metrics.

Your agent also handles necessary setup tools: it runs create_price_plan to define new cost structures; and while you might get a list of all customers using list_customers, your agent uses specific functions like create_customer or update_customer when the data actually needs changing. You can retrieve the full details for any known account ID with get_account; and if you need to verify current feature access, it calls check_entitlement.

The server exposes a complete set of tools that lets your agent manage everything from raw event ingestion to final invoice review.