MCP Tools

These tools are available when connected via MCP. See MCP Setup for connection instructions.

App Management

Tool	Description
init_app	Create a new app. Returns app_id and API base URL.
list_apps	List all apps with metadata.
delete_app	Permanently delete an app. Irreversible.
get_app_config	Read app configuration (CORS, JWT, storage limits).
update_cors	Set allowed CORS origins.
update_jwt_config	Configure access/refresh token lifetimes.
generate_service_key	Generate a bb_sk_ API key. Shown only once.

Schema & Migrations

Tool	Description
get_schema	Read current database schema.
apply_schema	Apply declarative schema. Set dry_run: true to preview.
dry_run_schema	Preview SQL without executing.
list_migrations	View migration history.

Data Operations

Tool	Description
select_rows	Query rows with filtering, sorting, pagination.
insert_row	Insert a row into a table.

Authentication & Security

Tool	Description
configure_oauth_provider	Register a social sign-in provider.
get_oauth_config	List configured OAuth providers.
update_oauth_provider	Modify an OAuth provider.
delete_oauth_provider	Remove an OAuth provider.
enable_rls	Enable row-level security on a table.
create_policy	Create a custom RLS policy.
create_user_isolation_policy	Quick user isolation setup.
get_rls_policies	List active RLS policies.
delete_rls_policy	Remove RLS from a table.
query_audit_logs	Search auth audit logs.

Storage

Tool	Description
generate_upload_url	Get a presigned upload URL.
generate_download_url	Get a presigned download URL.
get_storage_objects	List all files.
delete_storage_object	Delete a file.

Serverless Functions

Tool	Description
deploy_function	Deploy a TypeScript/JavaScript function.
list_functions	List deployed functions.
invoke_function	Test-invoke a function.
delete_function	Delete a function.
update_function_env	Update environment variables.
get_function_logs	View invocation logs.

Frontend Deployment

Tool	Description
create_frontend_deployment	Create deployment and get upload URL.
start_frontend_deployment	Start deployment after upload.
list_frontend_deployments	View deployment history.
set_frontend_env	Configure build environment variables.

Realtime

Tool	Description
configure_realtime	Enable realtime on tables.
get_realtime_config	View realtime configuration.

Feedback & Documentation

Tool	Description
submit_suggestion	Submit feedback, bug reports, or feature requests.
butterbase_docs	Read documentation by topic.