Billing & Plans

Bridge Town offers two plans: Free and Pro. This guide explains what each plan includes, how to upgrade or manage billing, and how agents should handle plan-gated errors.

Plans overview

	Free	Pro
Price	$0 forever	$20/month
Projects	Unlimited	Unlimited
Compute	Unlimited	Unlimited
AI access	Claude.ai, ChatGPT, OpenCode, or any MCP client	Same as Free
Workspace members	1 (solo)	Unlimited
Project sharing & collaboration	—	✓
Dashboard sharing	—	✓
Priority support	—	✓

Free plan is designed for individual analysts who want to build and run models on their own. Pro unlocks collaboration, sharing, and team workflows.

Local execution

Local execution (running models in your own Docker environment via CI) is available on Pro. See the GitHub Actions CI guide for setup details.

What requires Pro

The following features and MCP tools require an active Pro subscription.

Collaboration

• invite_project_collaborator — add teammates to a project
• invite_user — invite a user to the workspace

Sharing

• share_dashboard — generate a public pre-signed URL for a dashboard
• share_model — copy a model into another tenant’s project

Templates

• publish_project_template — mark a project as an internal workspace template

Free-tier tenants can still use list_project_collaborators, change_collaborator_role, remove_project_collaborator, and create_project_from_template on projects they already have access to. They can also create and view dashboards inside the web app — they just cannot generate external share URLs.

Upgrading to Pro

1. Sign in to the Bridge Town web app.
2. Navigate to Settings → Billing (/settings/billing).
3. Click Upgrade to Pro — $20/month.
4. You are redirected to Stripe Checkout to enter payment details.
5. After successful payment, your workspace is upgraded immediately.

The upgrade path is always through the web app UI. Agents and API callers cannot trigger upgrades via MCP tools or the REST API.

Managing your subscription

Pro subscribers can manage billing through the Stripe Customer Portal:

1. Go to Settings → Billing.
2. Click Open Customer Portal.
3. From the portal you can:
   • Update payment method
   • View and download invoices
   • Cancel your subscription

Cancellation and renewal

If you cancel Pro, the subscription remains active until the end of the current billing period. During this time:

• Your plan status shows active (cancelling) in Settings → Billing.
• The cancellation date is displayed.
• You retain Pro access until that date.

At the end of the period, the workspace automatically downgrades to Free. Any shared dashboards or active collaborator invites created while on Pro remain in place, but you will not be able to create new shares or invites until you re-upgrade.

If your subscription renews successfully, the status shows active with the next renewal date.

Do not mutate the plan field directly

Plan changes must go through Stripe Checkout or the Stripe Customer Portal. The update_tenant_settings tool explicitly rejects direct plan changes with the error “Plan upgrades and downgrades must go through Stripe billing.”

Plan-gated errors — agent guidance

When a Free-tier user tries to use a Pro-only feature, the MCP server returns a plan-required error.

Example error:

{
  "error": "plan-required",
  "message": "This feature requires a Pro plan.",
  "recovery": "Upgrade in Settings → Billing."
}

What agents should do:

1. Do not attempt to change the tenant plan with update_tenant_settings — it will fail.
2. Tell the user which feature requires Pro and why.
3. Direct them to Settings → Billing in the web app to upgrade.
4. Offer to help with alternative Free-tier workflows if applicable (e.g., exporting dashboard data manually instead of sharing a link).

Common plan-gated scenarios:

Feature	Free-tier behavior	Agent response
Invite a collaborator	plan-required error	”Project sharing requires Pro. You can upgrade in Settings → Billing.”
Share a dashboard	plan-required error	”Dashboard sharing requires Pro. You can still view the dashboard inside the app, or I can help export the data.”
Publish a template	plan-required error	”Publishing templates requires Pro. You can still create projects from existing templates.”
Share a model cross-tenant	plan-required error	”Cross-tenant model sharing requires Pro. You can copy the model code manually if the recipient has their own workspace.”

Checking current plan and usage

Agents can query the current subscription state and usage counters via MCP resources:

• subscription://current — plan name, Stripe status, billing period end, and cancellation flag.
• usage://current — project count, API token count, and model-run minutes consumed this month.

Use these resources when a user asks “What plan am I on?” or “Am I close to a limit?” without making a destructive tool call.

Related documentation

Topic	Link
Public pricing page	bridgetown.builders/pricing
Project collaboration model	/docs/concepts/collaboration/
Team collaboration guide	/docs/guides/team-collaboration/
Dashboards guide	/docs/guides/dashboards/
Tenant settings (read)	/docs/tools/admin/get-tenant-settings/
Tenant settings (update)	/docs/tools/admin/update-tenant-settings/