> ## Documentation Index
> Fetch the complete documentation index at: https://agentheya.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pricing

> Set up subscription tiers to monetise your agent and manage Stripe Connect for payments.

<Info>
  **Field reference:** [`pricing`](/reference/pricing) — every field, type, default, and tier for this page.
</Info>

The Pricing page lets you configure subscription tiers for your agent and connect Stripe to collect payments. Subscribers subscribe to a tier from your agent's public `/pricing` page to unlock higher usage limits or premium features.

## Connecting Stripe

Agentheya uses **Stripe Connect** to process payments. The platform handles billing infrastructure; payouts go directly to your Stripe account.

1. Open your agent and go to **Pricing** in the sidebar.
2. In the **Stripe Account** card click **Activate Stripe Connect**.
3. Complete the Stripe-hosted onboarding flow (authentication or new-account creation).
4. You're redirected back to this page; the card now shows account status, business name, region, and connection date.

Agentheya keeps a **20% platform fee** on every subscriber payment via Stripe's `application_fee_percent` mechanism. The remaining 80% is paid by Stripe directly to your connected account.

### Account status

Once connected the card shows one of:

* **Ready to charge** — onboarding complete, charges accepted.
* **Verification pending** — Stripe has your details and is reviewing them.
* **Onboarding incomplete** — click **Continue onboarding** to resume the Stripe flow.
* **Test mode** — present when the account is a Stripe test-mode account.

Use **Refresh status** to re-poll Stripe, **Open Stripe Dashboard** to jump to Stripe, or **Disconnect** to detach the account from this agent. Disconnecting disables billing for the agent until you reconnect.

## Creating pricing tiers

Click **Add Tier** in the **Add Pricing Tier** card to create a tier. Each tier card supports:

| Field                             | Description                                                                                                                                                                                                                                                     |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tier name**                     | Required. Shown at the top of the tier card.                                                                                                                                                                                                                    |
| **Subtitle**                      | Heavier sub-line under the price (e.g. "Resell to your subscribers").                                                                                                                                                                                           |
| **Tagline**                       | Short marketing line.                                                                                                                                                                                                                                           |
| **Currency**                      | `USD`, `EUR`, `GBP`, `JPY`, `AUD`, `CAD`.                                                                                                                                                                                                                       |
| **Button label**                  | CTA on the public pricing card (defaults to "Select Plan").                                                                                                                                                                                                     |
| **Subscriber dashboard pages**    | Per-page access control — which dashboard pages a subscriber who buys this tier can see. Leave open for full access, or restrict lower tiers to a subset.                                                                                                       |
| **Price options**                 | One or more `{ credits_per_month, price_cents }` rows. A tier with no price options can't be selected. `credits_per_month` is the subscriber's monthly credit allowance; credits reset at the start of each billing period and unused credits do not roll over. |
| **Section 1 items**               | Bullet list of features, one per line.                                                                                                                                                                                                                          |
| **Section 2 heading** + **items** | Optional second feature section with its own heading.                                                                                                                                                                                                           |

Tiers can be collapsed for readability and deleted with the trash icon. The **Live preview** below the editor renders the tier grid exactly as subscribers will see it.

### Examples

**Hello world — one paid plan.** Connect Stripe, add a single tier: name "Pro", one price option of `1000 credits / $20`, and three feature bullets. Subscribers see one card with a "Select Plan" button that runs Stripe Checkout. The simplest way to charge for access.

**Simple — free + paid.** Add two tiers: "Free" (`100 credits / $0`, highlight off) and "Pro" (`2000 credits / $29`, highlight on). Subscribers start free and upgrade when they hit the credit ceiling. The highlighted card draws the eye to the plan you want them on.

**Medium — three tiers with feature gating.** "Starter / Team / Business" at increasing credit allotments and prices. Use **Subscriber dashboard pages** to restrict Starter buyers to just the chat + usage pages, give Team access to connectors and memory, and open everything to Business. The same agent, sold at three capability levels, with the dashboard each buyer sees scaled to what they paid for.

**Complex — multi-currency resale across regions.** Build the tier set once, then offer it in USD, EUR, and GBP by setting the currency per tier (or maintaining parallel tier sets). Use **Download JSON** to export your canonical tier definitions and **Upload JSON** to clone them across several agents you run for different markets — keeping pricing consistent without re-entering it by hand. Each agent's Stripe Connect account collects in its local currency; the platform's application fee applies on top.

## Download / upload tier definitions

* **Download JSON** — exports your current tier list as JSON. Useful for backup or copying between agents.
* **Upload JSON** — replace the entire tier list from a JSON file. The file can be either an array of tiers or an object with a `tiers` key. Validation errors are shown if the shape is wrong.

## Managing subscribers

Subscribers appear on the **Users** page with their current plan, monthly cost, and tokens-per-month allotment shown. Use the Users page to top up credits manually or manage individual accounts — you can also cancel or modify individual subscriptions and issue manual credit adjustments. Billing and usage events also appear in the **Activity** log alongside conversation history.

Each subscriber sees their own tier, credit balance, and usage breakdown on their own subscriber dashboard — a useful reference for what the tiers you configure look like from the subscriber's side.

## Manage via the Management MCP

This page can be configured programmatically through the [Management MCP](/manage-mcp) — useful for AI agents and CI pipelines.

|               |                                                                                             |
| ------------- | ------------------------------------------------------------------------------------------- |
| Endpoint      | `https://manage.agentheya.com/mcp`                                                          |
| Tool          | `config.set`                                                                                |
| Section       | `pricing`                                                                                   |
| Schema (HTTP) | [`GET /api/manage-mcp/schema/pricing`](https://agentheya.com/api/manage-mcp/schema/pricing) |

Example:

```json theme={null}
{
  "tool": "config.set",
  "owner_id": "<your owner_id>",
  "agent_id": "<your agent_id>",
  "section": "pricing",
  "data": { /* see schema for accepted fields */ }
}
```

Partial updates are supported — only the fields you include are changed. Call `config.get` to read the current values and `schema.get` (or the HTTP schema URL above) to see the full field list.