# Togai MCP for AI Agents AI Agent Connect

> Togai MCP automates usage-based billing and real-time metering. You can ingest usage events, manage customer billing accounts, and check feature entitlements directly through your AI agent. It handles the heavy lifting of revenue operations, making it easy to track product consumption and manage financial health without switching tabs.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_fQ0G3Hq7bnfabZ90Y116udh8XVkuPLEp5DIPRXii/ai-agent-connect
- **Tags:** usage-based-billing, metering, fintech, revenue-operations, pricing-strategy

## Description

Managing usage-based pricing is usually a headache of spreadsheets and manual database queries. Togai changes that by letting your AI agent handle the heavy lifting of revenue operations. Instead of digging through logs to see how much a customer actually used, you can just ask your agent to check a balance or list recent invoices. You can push raw data into the system to track consumption in real-time, define how those events turn into billable units, and manage the lifecycle of your customers from signup to billing. It connects your billing logic to your daily workflow, so you spend less time on data entry and more time on strategy. Because Vinkius hosts this Connector, it plugs right into your existing setup, giving you a unified way to handle complex pricing models without building custom internal tools.

## Tools

### get_metrics
Pull aggregated usage metrics for analysis. Use this to see high-level consumption trends.

### get_wallet_balance
Check the current available balance for a customer's wallet. This is great for checking remaining funds.

### grant_credit
Add money or credits to a customer's account balance. Use this for promotions or refunds.

### ingest_batch_events
Upload a large group of usage events at once. This is the fastest way to sync historical data.

### ingest_event
Send a single usage event to the system for real-time tracking. Use this for live consumption data.

### list_accounts
Show a list of all accounts in your system. This lets you browse your entire billing base.

### list_customers
Browse all registered customers in your database. Use this to manage your customer list.

### list_invoices
View and filter through your list of active and past invoices. This helps you track payments.

### list_rate_cards
See the different rate cards available for a price plan. Use this to check specific pricing rules.

### update_account
Modify the details of an existing billing account. Use this to keep account info current.

### check_entitlement
Check if a specific customer has access to a particular feature. This helps you verify permissions instantly.

### create_account
Create a new billing account for a customer. Use this to set up new billing profiles.

### create_customer
Register a new legal entity or customer in the system. This establishes a new customer profile.

### create_price_plan
Set up a new price plan with specific pricing rules. Use this to build out your pricing tiers.

### create_usage_meter
Define the logic for turning raw events into billable units. This is how you calculate costs.

### get_account
Pull all the details for a specific billing account. Use this to see account-specific data.

### get_customer
Retrieve the profile and details of a specific customer. This gives you a full customer overview.

### get_entitlements
List all the features and limits for a specific account. This shows everything a user can access.

### update_customer
Edit the information for a customer record. Use this to update legal or billing details.

## Prompt Examples

**Prompt:** 
```
What's the current balance for customer 'acc_987'?
```

**Response:** 
```
The account **acc_987** currently has a balance of **$150.00** available in their wallet. 

Would you like me to perform any other actions on this account, such as granting credits or listing recent invoices?
```

**Prompt:** 
```
Can I give 'cust_123' a $50 credit?
```

**Response:** 
```
I've added a **$50.00** credit to the wallet for customer **cust_123**. 

*   **Previous Balance:** $125.00
*   **Added Credit:** $50.00
*   **New Balance:** $175.00

Let me know if you need anything else!
```

**Prompt:** 
```
Does 'acc_vink_01' have access to the 'premium_api'?
```

**Response:** 
```
I checked the entitlements for account **acc_vink_01**. 

| Feature | Access Status |
| :--- | :--- |
| premium_api | ❌ No Access |

They currently do not have access to this feature. Would you like me to check their current price plan?
```

## Capabilities

### Ingest usage events
Push raw data to track product consumption in real-time.

### Manage customer accounts
Create and update billing entities and accounts.

### Define usage meters
Set up how raw events translate into billable units.

### Check feature entitlements
Instantly verify if a customer has access to a specific feature.

### Monitor billing health
View wallet balances and list invoices for any account.

### Grant account credits
Add credits to customer wallets to manage promotional offers.

## Use Cases

### Verifying feature access for support
A customer claims they can't see a feature. Use get_entitlements to check their status immediately and provide a clear answer.

### Syncing historical usage logs
You need to process a batch of logs from last night. Use ingest_batch_events to sync the data into Togai in one go.

### Granting promotional credits
A high-value client needs a credit. Use grant_credit to add funds to their wallet without opening a complex billing tool.

### Auditing monthly revenue
You're auditing last month's revenue. Use list_invoices to pull a filtered list of all paid bills for a specific period.

## Benefits

- Stop manual data entry by using ingest_event to push usage data automatically into your billing system.
- Verify customer access instantly with check_entitlement to avoid unnecessary support tickets regarding feature access.
- Manage your entire customer base from one place using list_customers and list_accounts to see every profile.
- Track financial health in real-time by pulling wallet balances with get_wallet_balance for any account.
- Handle complex pricing logic easily by setting up meters with create_usage_meter to define billable units.
- Simplify promotional offers by using grant_credit to add value to customer accounts without manual database edits.

## How It Works

The bottom line is you get a conversational interface for your entire revenue and metering stack.

1. Connect your Togai API key to the Connector.
2. Choose your preferred AI client like Claude or Cursor.
3. Ask your agent to perform tasks like checking balances or ingesting event batches.

## Frequently Asked Questions

**What does the Togai MCP do for my business?**
The Togai MCP connects your billing and usage data to your AI agent. It lets you manage customer accounts, check balances, and verify feature access through simple conversation instead of clicking through multiple dashboards.

**How can I use the Togai MCP to manage customer billing?**
You can use it to create new billing accounts, update customer information, and view invoices. It makes it much faster to handle administrative tasks for your customers.

**Can I use the Togai MCP to check if a customer has a specific feature?**
Yes, you can ask your agent to instantly verify if a customer has access to a specific tool or feature. This is great for quick support checks.

**How do I ingest usage data with the Togai MCP?**
You can ask your agent to push single events or entire batches of usage data into Togai. This ensures your billing system stays updated with real-time consumption.

**Can the Togai MCP help me manage customer credits?**
Yes, you can use it to grant credits to customer wallets. This is a fast way to handle promotions, refunds, or special adjustments for your clients.

**Is the Togai MCP good for usage-based pricing models?**
It is specifically designed for it. It handles the complex logic of turning raw usage events into billable units and monitoring those metrics across your customer base.

**How do I verify if a customer has access to a specific feature?**
You can use the `check_entitlement` tool by providing the account ID and the feature ID. The agent will return whether the customer is entitled to use that feature based on their current plan.

**Can I check the remaining credit balance for a specific account?**
Yes, use the `get_wallet_balance` tool with the target account ID. It will retrieve the current balance, including any granted credits or prepaid amounts.

**Is it possible to list all invoices for a customer to check payment status?**
Absolutely. Use the `list_invoices` tool. You can filter or browse through the generated invoices to see which ones are paid, pending, or overdue.