# Stigg MCP for AI Agents AI Agent Connect

> Stigg MCP lets you manage SaaS billing, subscriptions, and customer profiles through your AI agent. It handles provisioning, plan updates, and real-time usage reporting for metered features, moving you away from manual dashboard clicking and spreadsheet tracking.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_6N2TOJAyHFeDsPnzGGSq4Px2GqFliWpbYU9iV2r9/ai-agent-connect
- **Tags:** billing, subscriptions, saas-pricing, usage-based-billing, customer-management

## Description

Connect your Stigg account to your AI agent to take full control of your pricing and packaging workflows. You can manage the entire customer lifecycle from provisioning to usage reporting through natural conversation. This Connector is part of the Vinkius catalog, allowing you to plug into your existing AI client without complex setup. Instead of jumping between tabs to check a customer's entitlement or manually reporting usage, your agent acts as a billing operations assistant. You can create customer profiles, provision new subscriptions, or fetch active plan details using both REST and GraphQL. It's designed to make SaaS billing feel like a conversation rather than a series of manual dashboard entries. You can handle the tedious parts of account management, like updating customer details or canceling plans, while keeping your data in sync. This means your team spends less time in the billing console and more time actually growing the business. It turns your agent into a functional member of the billing team that understands your specific pricing logic.

## Tools

### gql_provision_customer
Provision a customer and optional subscription via GraphQL. This is the most efficient way to handle new signups.

### gql_report_usage
Report usage via GraphQL. This helps you track how much of a feature a customer has consumed.

### rest_report_usage
Report usage for metered features via REST API. Use this to update billing for items like API calls or seats.

### rest_update_customer
Update a customer via REST API. Use this to fix typos or update contact details in your billing system.

### rest_cancel_subscription
Cancel a subscription via the REST API. Use this to stop a customer's access immediately upon churn.

### rest_create_customer
Create a new customer via REST API. This helps you onboard new users without manual data entry.

### rest_create_subscription
Create a subscription via REST API. Use this to assign a specific plan to a new user.

### rest_get_customer
Retrieve a customer via REST API. This is the fastest way to see who a user is and what they're paying for.

### rest_get_subscription
Retrieve a subscription via REST API. Use this to check the status of a specific plan.

### gql_get_customer
Get customer details via GraphQL. This is the preferred way to get deep customer information in a single call.

### gql_get_entitlements_state
Get entitlements state via GraphQL. Use this to verify permissions before granting access to a tool.

### gql_provision_subscription
Provision a subscription via GraphQL. Use this to update or add a plan to an existing account.

## Prompt Examples

**Prompt:** 
```
I need to set up a new customer named Sarah with the 'Pro' plan.
```

**Response:** 
```
I've created a customer profile for Sarah and provisioned her with the 'Pro' plan. Would you like me to verify her entitlements now?
```

**Prompt:** 
```
How many units did customer 123 use for the 'api-calls' feature?
```

**Response:** 
```
Customer 123 has used 450 units for the 'api-calls' feature today. I can report this usage to Stigg for you if you'd like.
```

**Prompt:** 
```
What can this user actually access?
```

**Response:** 
```
Customer 123 is on the 'Basic' plan. They have access to:

* Feature A
* Feature B

They do not have access to Feature C.
```

## Capabilities

### Create customer profiles
Generate new customer records with specific IDs and contact details via your AI agent.

### Provision new subscriptions
Assign specific plans and pricing tiers to customers instantly.

### Cancel active plans
Terminate subscriptions and handle churn directly through chat.

### Report metered usage
Log real-time usage units for features like API calls or seats.

### Fetch entitlement states
Check exactly what features a customer is allowed to access.

### Update customer details
Modify account information, emails, or status updates on the fly.

## Use Cases

### Onboarding a new trial user
A Customer Success rep asks the agent to provision a new trial. The agent uses gql_provision_customer to set up the account and plan in seconds.

### Reporting API usage for a metered plan
A developer needs to log usage for a customer. They tell the agent to report 500 units via rest_report_usage to ensure the next bill is accurate.

### Checking permissions for a support ticket
A support agent wants to know if a user has 'Admin' access. The agent pulls the current state using gql_get_entitlements_state.

### Updating a customer's email address
A user sends an email with a typo. The support lead tells the agent to fix it using rest_update_customer without opening the billing console.

## Benefits

- Stop manual data entry by using rest_create_customer to onboard new users instantly.
- Get real-time data with gql_get_entitlements_state to see exactly what a user can do.
- Automate usage tracking with rest_report_usage to ensure accurate metered billing.
- Speed up support by using rest_update_customer to fix account details on the fly.
- Clean up your records by using rest_cancel_subscription to handle churn efficiently.
- Simplify workflows by using gql_provision_customer to handle signups in a single step.

## How It Works

The bottom line is you get a hands-free way to manage SaaS billing and customer entitlements.

1. Subscribe to this Connector and grab your Stigg API Key from your dashboard.
2. Input the API Key into your AI client's configuration settings.
3. Ask your agent to perform tasks like provisioning a new user or checking a plan status.

## Frequently Asked Questions

**Can I use Stigg MCP to manage my SaaS subscriptions?**
Yes. This Connector connects your AI agent to your Stigg account so you can manage subscriptions, plans, and customer profiles through a chat interface.

**How does Stigg MCP help with usage-based billing?**
It allows your agent to report metered usage units in real-time. This ensures that features like API calls are billed accurately based on actual consumption.

**Can my AI agent provision new customers with Stigg MCP?**
Yes, your agent can create new customer profiles and provision their initial subscriptions using a single command, saving you from manual dashboard entry.

**Does Stigg MCP support both REST and GraphQL?**
It does. You can choose between REST and GraphQL actions depending on your specific needs, giving you flexibility in how your agent interacts with your billing data.

**Can I use Stigg MCP to check customer entitlements?**
Yes. You can ask your agent to check what features a specific customer is allowed to access, which is helpful for troubleshooting support tickets.

**How do I connect Stigg MCP to my AI client?**
Once you subscribe to the Connector, you just need to provide your Stigg API Key in your AI client's configuration. After that, your agent can start managing your billing.

**Can I provision a customer and a subscription in one go?**
Yes! Use the `gql_provision_customer` tool. It allows you to create the customer entity and optionally provide a `planId` to start their subscription immediately in a single GraphQL call.

**How do I report usage for a metered feature?**
You can use either `rest_report_usage` or `gql_report_usage`. Simply provide the `customerId`, the `featureId`, and the numeric `value` to update their metered usage in Stigg.

**Is it possible to cancel an active subscription via the agent?**
Yes, use the `rest_cancel_subscription` tool by providing the specific subscription ID. The agent will process the cancellation through Stigg's REST API.