# Plans

> Five Aerostack plan tiers with increasing resource limits and features. Yearly billing saves 25%. Compare plans and upgrade from the dashboard.

Aerostack offers five plan tiers. Each tier unlocks higher resource limits and additional features. All paid plans include a 25% discount for yearly billing.

---

## Plan Comparison

### Pricing

| Plan | Monthly | Yearly | Yearly Savings |
|------|---------|--------|----------------|
| **Free** | $0 | $0 | -- |
| **Starter** | $19/mo | $171/yr ($14.25/mo) | 25% |
| **Pro** | $49/mo | $441/yr ($36.75/mo) | 25% |
| **Business** | $149/mo | $1,341/yr ($111.75/mo) | 25% |
| **Enterprise** | Custom | Custom | Negotiated |

---

## Resource Limits

### Core Resources

| Resource | Free | Starter | Pro | Business | Enterprise |
|----------|------|---------|-----|----------|------------|
| Projects | 10 | 5 | Unlimited | 50 | Unlimited |
| Team Members | 1 | 3 | 10 | 25 | Unlimited |
| MCP Workspaces | 3 | 10 | 50 | 200 | Unlimited |
| Gateway APIs | 3 | 10 | 50 | 200 | Unlimited |
| Realtime Connections | 200 | 1,000 | 5,000 | 25,000 | Unlimited |

### Monthly Quotas

| Quota | Free | Starter | Pro | Business | Enterprise |
|-------|------|---------|-----|----------|------------|
| API Requests | 50K | 500K | 2M | 10M | Unlimited |
| AI Tokens | 100K | 1M | 10M | 100M | Unlimited |
| Storage | 2.5 GB | 7 GB | 30 GB | 110 GB | Unlimited |

### MCP & Workspaces

| Feature | Free | Starter | Pro | Business | Enterprise |
|---------|------|---------|-----|----------|------------|
| Workspaces | 3 | 10 | 50 | 200 | Unlimited |
| Servers per Workspace | 5 | 15 | 50 | 200 | Unlimited |
| MCP Proxy Calls/mo | 5K | 50K | 500K | 5M | Unlimited |
| Workspace Secrets | 10 | 50 | 200 | 1,000 | Unlimited |

### Gateway APIs

| Feature | Free | Starter | Pro | Business | Enterprise |
|---------|------|---------|-----|----------|------------|
| Gateway APIs | 3 | 10 | 50 | 200 | Unlimited |
| Consumer Keys per API | 10 | 100 | 1,000 | 10,000 | Unlimited |
| Gateway Requests/mo | 5K | 50K | 500K | 5M | Unlimited |
| Knowledge Docs per API | 10 | 100 | 1,000 | 10,000 | Unlimited |

### Authentication

| Feature | Free | Starter | Pro | Business | Enterprise |
|---------|------|---------|-----|----------|------------|
| Monthly Active Users | 50K | 100K | 500K | 1M | Unlimited |
| Email Sends/mo | 1K | 10K | 100K | 500K | Unlimited |

### Realtime

| Feature | Free | Starter | Pro | Business | Enterprise |
|---------|------|---------|-----|----------|------------|
| Concurrent Connections | 200 | 1,000 | 5,000 | 25,000 | Unlimited |
| Messages/mo | 50K | 500K | 5M | 50M | Unlimited |
| Rooms | 5 | 50 | 500 | 5,000 | Unlimited |
| Chat History | 7 days | 30 days | 90 days | 365 days | Unlimited |

### Observability

| Feature | Free | Starter | Pro | Business | Enterprise |
|---------|------|---------|-----|----------|------------|
| Log Retention | 1 day | 7 days | 30 days | 90 days | Custom |
| Error Tracking | 100 | 1,000 | 10,000 | Unlimited | Unlimited |

### Per-Project Limits

| Feature | Free | Starter | Pro | Business | Enterprise |
|---------|------|---------|-----|----------|------------|
| Custom Hooks | 5 | 15 | 50 | 200 | Unlimited |
| API Keys | 10 | 50 | 200 | 1,000 | Unlimited |

---

## Burst Rate Limits

In addition to monthly quotas, each plan has per-minute burst limits to prevent abuse:

| Metric | Free | Starter | Pro | Business |
|--------|------|---------|-----|----------|
| Requests/min | 100 | 500 | 2,000 | 10,000 |
| DB Writes/min | 30 | 150 | 600 | 3,000 |
| Uploads/min | 10 | 50 | 200 | 1,000 |
| AI Calls/min | 5 | 25 | 100 | 500 |

---

## Storage Breakdown

The storage quota is shared across three storage types:

| Storage Type | Free | Starter | Pro | Business |
|-------------|------|---------|-----|----------|
| Database | 500 MB | 2 GB | 5 GB | 10 GB |
| File Storage | 2 GB | 5 GB | 25 GB | 100 GB |
| Vector Search | 2K vectors | 20K vectors | 200K vectors | 1M vectors |
| Media Assets | 500 | 5,000 | 50,000 | 200,000 |

---

## AI Token Breakdown

AI tokens are shared across three categories:

| Category | Free | Starter | Pro | Business |
|----------|------|---------|-----|----------|
| Gateway Inference | 50K | 500K | 5M | 50M |
| Embedding Operations | 1K | 10K | 100K | 1M |
| Vector Search Queries | 5K | 50K | 500K | 5M |

---

## Grace Periods

When you approach your monthly quota, Aerostack provides a grace buffer before hard-blocking requests:

| Plan | Grace Buffer |
|------|-------------|
| Free | 10% over limit |
| Starter | 15% over limit |
| Pro | 20% over limit |
| Business | 20% over limit |

For example, on the Starter plan with 500K API requests/month:
- **0 - 500K**: normal operation
- **500K - 575K**: grace zone (requests succeed, dashboard warning shown)
- **575K+**: hard block (requests return `403`)

  Grace periods ensure your app does not suddenly break when you hit a limit. Use the usage API (`GET /api/billing/usage`) to monitor your consumption and upgrade proactively.

---

## Enterprise Plan

The Enterprise plan uses the Business tier as a base with custom overrides negotiated per account. Enterprise features include:

- **Unlimited** resources across all categories
- **Custom limits** stored as JSON overrides in the database
- **Dedicated support** with SLA guarantees
- **Custom marketplace fees** (negotiable)
- **SSO/SAML** integration
- **Audit logs** with extended retention
- **Dedicated infrastructure** options

Contact [sales@aerostack.dev](mailto:sales@aerostack.dev) for Enterprise pricing.

---

## Marketplace Fee

All plans include a marketplace fee on revenue earned from community marketplace sales (functions, skills, agents). Enterprise customers can negotiate custom rates.

The marketplace fee applies only to revenue you earn as a creator. Using marketplace tools as a consumer is covered by the pay-per-use wallet.

---

## Switching Plans

### Upgrading

When you upgrade, the new plan takes effect immediately. You are charged the prorated difference for the remainder of your current billing period.

### Downgrading

When you downgrade or cancel, you keep your current plan until the end of the billing period. After that, you move to the lower plan. Resources exceeding the new plan's limits become read-only until you delete them or upgrade again.

  Before downgrading, check that your current resource usage fits within the target plan's limits. The dashboard shows which resources would exceed the new plan.

---

## Fetching Plans via API

```bash
curl https://api.aerostack.dev/api/billing/plans
```

Returns all plans with pricing and features:

```json
{
  "plans": [
    {
      "tier": "free",
      "name": "Free",
      "price_cents": 0,
      "yearly_price_cents": 0,
      "features": [
        "10 projects", "50,000 API requests/mo", "2.5 GB storage",
        "100,000 AI tokens/mo", "200 realtime connections",
        "3 Gateway APIs", "3 MCP Workspaces"
      ]
    },
    {
      "tier": "starter",
      "name": "Starter",
      "price_cents": 1900,
      "yearly_price_cents": 17100,
      "yearly_savings_cents": 5700,
      "yearly_savings_percent": 25,
      "features": [
        "5 projects", "500,000 API requests/mo", "7 GB storage",
        "1,000,000 AI tokens/mo", "1,000 realtime connections",
        "10 Gateway APIs", "10 MCP Workspaces", "3 team members"
      ]
    }
  ]
}
```