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	$10/month per active workspace member
Models	Unlimited	Unlimited
Compute	Unlimited	Unlimited
AI access	Claude.ai, ChatGPT, OpenCode, or any MCP client	Same as Free
Workspace members	1 (solo)	Unlimited — billed per active member
Model 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_model_collaborator — add teammates to a model
• Workspace user invitations are handled in the web app and the Admin and Security API/CLI guide, not through MCP.

Sharing

• share_dashboard — share a dashboard with model collaborators via an authenticated link
• request_model_share — request to share a model with another tenant (pending until accepted)
• accept_model_share_request — accept a pending share request and receive the model
• reject_model_share_request — decline a pending share request
• sync_shared_model — update an accepted share with the latest source
• revoke_model_share — revoke an accepted share relationship
• list_model_share_requests — list share requests sent or received

Templates

• create_model_from_template — create a model from a workspace template
• Template publish/unpublish governance is handled through the web app and the Admin and Security API/CLI guide, not MCP.

Free-tier tenants can still use list_model_collaborators, change_collaborator_role, remove_model_collaborator, and create_model_from_template on models 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 — $10/month per member.
4. You are redirected to Stripe Checkout to enter payment details. The subscription quantity is set to your workspace’s current active member count (minimum 1).
5. After successful payment, your workspace is upgraded immediately.

Adding or removing workspace members afterward automatically keeps your Stripe subscription quantity in sync — no separate action is needed.

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. Admin and tenant-settings APIs reject 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 through MCP — no MCP tool can upgrade or downgrade a workspace.
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	”Model 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 models 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. The workflow is: request_model_share → the recipient calls accept_model_share_request.”

Checking current plan and usage

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

• get_subscription — plan name, Stripe status, billing period end, and cancellation flag.
• get_usage — model count, API token count, and model-run minutes consumed this month.

Use these tools when a user asks “What plan am I on?” or “Am I close to a limit?” — they are read-only (readOnlyHint=true, idempotentHint=true).

Related documentation

Topic	Link
Public pricing page	bridgetown.builders/pricing
Model collaboration	/docs/concepts/collaboration/
Team collaboration guide	/docs/guides/team-collaboration/
Dashboards guide	/docs/guides/dashboards/
Tenant settings and admin API	/docs/guides/admin-security-api-cli/