Pricing

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

Field reference: pricing — every field, type, default, and tier for this page.

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 — 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

Example:

{
  "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.