Skip to main content
Each MeshAI plan includes a maximum number of active agents. An active agent is any agent that sent at least one heartbeat or telemetry event during the current billing period.

​
Limits by Plan

PlanAgent Limit
Starter25
Professional100
Enterprise1,000
Enterprise PlusUnlimited

​
What Happens When You Hit the Limit

When you reach your plan’s agent limit:
  1. Existing agents continue working — monitoring, policies, and proxy routing are unaffected for already-registered agents.
  2. New registrations are blocked — attempts to register a new agent return a 402 error:
{
  "success": false,
  "error": "Agent limit reached. Your Starter plan allows 25 agents. Upgrade to register more.",
  "current_count": 25,
  "plan_limit": 25,
  "upgrade_url": "https://app.meshai.dev/settings"
}
  1. Dashboard notification — a banner appears in the dashboard when you’re at 80% and 100% of your limit.

​
Checking Your Usage

curl https://api.meshai.dev/billing \
  -H "Authorization: Bearer msh_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "plan": "starter",
    "active_agents": 23,
    "agent_limit": 25,
    "billing_period_start": "2026-03-01T00:00:00Z",
    "billing_period_end": "2026-03-31T23:59:59Z",
    "monthly_cost_usd": 299.00
  }
}

​
How to Upgrade

1

Go to Billing settings

Navigate to app.meshai.dev/settings.
2

Select a plan

Choose the plan that fits your agent count. The prorated difference is charged immediately.
3

Confirm

Your new limit takes effect immediately. You can register additional agents right away.
You can also upgrade programmatically: 
curl -X POST https://api.meshai.dev/billing/checkout \
  -H "Authorization: Bearer msh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "plan": "professional" }'

​
Deactivating Agents

If you don’t want to upgrade, you can free up slots by deleting agents you no longer need: 
curl -X DELETE https://api.meshai.dev/agents/agt_abc123 \
  -H "Authorization: Bearer msh_YOUR_API_KEY"
Deleted agents are removed from your active count immediately but remain in the audit trail for compliance purposes.