{"id":"io.github.supero-platform/supero","slug":"io-github-supero-platform-supero","title":"Supero","description":"Multi-tenant backend your coding agent configures over MCP: auth, RBAC, data, workflows, deploy.","version":"2.1.0","publisher":{"kind":"github","id":"supero-platform","label":"@supero-platform on GitHub","url":"https://github.com/supero-platform"},"website":"https://supero.dev/?ref=mcp-registry","repository":"https://github.com/supero-platform/supero-mcp","remotes":[{"type":"streamable-http","url":"https://mcp.supero.dev/mcp"},{"type":"streamable-http","url":"https://api.supero.dev/mcp/v1/messages","headers":[{"description":"Supero project API key (ak_...). Create one at app.supero.dev under your project's API keys. The key carries its own scope: every tool call is evaluated against the roles attached to it.","isRequired":true,"isSecret":true,"name":"X-API-Key"}]}],"packages":[],"published":"2026-11-17","updated":"2026-11-17","status":"online","auth":"","latency_ms":1768,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"build_get_skills","title":"Build: Get Skills","description":"Returns Supero's build guides describing schemas, services and the recommended build sequence. topic='core' (~20KB) returns the core build rules plus the topic index; other topics (build_plan names the relevant ones, e.g. topic='schemas,access') return those sections verbatim. doc selects the guide: 'skills' (default, the full ~280KB specification), 'components' (the SDK component catalog), 'rubri","read_only":true},{"name":"build_get_examples","title":"Build: Get Examples","description":"Returns a complete reference app (schemas.py, config.py, setup.py, ui/app.js) for an archetype. archetype='index' (default) lists the archetypes with file sizes: commerce-storefront, commerce-marketplace, service-booking, ops-dashboard, multitenant-portal, saas-billing, events. Optional file= returns one file. Useful as a pattern source for structure, landing page and schemas when authoring a simi","read_only":true},{"name":"build_plan","title":"Build: Plan","description":"Turns an app description into a build checklist, without an LLM. Input: description, plus optional entities, is_multi_tenant and public_facing. Returns the detected vertical with its usual pages and terms, the entities that need a detail page, the multi-tenant login pattern, seed-data guidance, the build_get_examples archetype to follow and the guide topics that apply. Useful after reading the bui","read_only":true},{"name":"build_get_service_contract","title":"Build: Get Service Contract","description":"Returns the contract of a transactional platform service (cart, order, payment, booking, appointment, membership, approval, document_signature, recurring_plan, inventory, task, ticket, loyalty_points, rental, comment, attachment, feedback, notification, product, service, customer, workflows): its state machine, its operations with input fields and resulting states, the base schemas and mandatory f","read_only":true},{"name":"build_whoami","title":"Build: Whoami","description":"Returns the scope of the current credential: role (domain_admin / project_admin), domain, whether it can create projects, the project it is limited to (if any) and the plan. No inputs. Useful at the start of a session to know whether a project is already fixed or one has to be chosen or created.","read_only":true},{"name":"build_list_projects","title":"Build: List Projects","description":"Lists the projects this credential can build into: uuid, name, schema_namespace and live_url. Input: optional limit. Useful for choosing a project on a domain-wide credential.","read_only":true},{"name":"build_get_project","title":"Build: Get Project","description":"Returns one project's details for project_uuid: schema_namespace (the exact value every schema uses as its namespace), the last published version, and the captured project_intent: the brief, the discovered data model (entities, relationships, status workflows) and the landing intent. The project_intent is the spec the user already gave for this app.","read_only":true},{"name":"build_create_project","title":"Build: Create Project","description":"Creates a new project (domain-admin credentials only; plan-gated). Inputs: name, plus optional display_name, schema_namespace, description, requirements and is_multi_tenant. Returns the project uuid, its schema_namespace and an API key that is shown only once. Used for a new app.","read_only":false},{"name":"build_update_project","title":"Build: Update Project","description":"Updates a project's metadata (display_name, description, show_public, live_url) from patch. Inputs: project_uuid, patch. Returns the updated project.","read_only":false},{"name":"build_set_project_mode","title":"Build: Set Project Mode","description":"Sets a project's build mode. 'dev' (default) allows a complete replace, which wipes app data and keeps credentials; 'live' makes a replace refuse, protecting production data. Inputs: project_uuid, mode. Returns the new mode.","read_only":false},{"name":"build_replace_project","title":"Build: Replace Project","description":"Destructive: completely replaces a dev-mode project's app and wipes its data (credentials, API keys, namespace and tenant are kept). Domain-admin credentials only; refused when mode='live'; confirm_project_name has to equal the project's name. When files are passed they are validated first (a bad bundle wipes nothing) and published afterwards; without files it only wipes, and build_publish follows","read_only":false},{"name":"build_validate","title":"Build: Validate","description":"Validates an authored bundle against the live platform without running it (static AST checks): manifest, syntax, import safety, config exports, schema validity and namespace equal to the project's schema_namespace. Inputs: project_uuid and the files as files, files_b64gz or files_ref. Returns errors and warnings by file and schema. Free; useful before every publish.","read_only":true},{"name":"build_publish","title":"Build: Publish","description":"Packages and uploads an authored bundle and records a new version under the project. Runs build_validate first; force=true overrides soft errors only. Inputs: project_uuid and the files as {relative_path: content} (files), files_b64gz or files_ref. Returns version_uuid, file_id and download_url.","read_only":false},{"name":"build_stage_bundle","title":"Build: Stage Bundle","description":"Returns an out-of-band upload endpoint for a bundle too large to send inline (inline files are limited by the client model's output size). A gzip(json {path: content}) blob uploaded there with the connection's own key yields a file_id, which build_validate, build_publish and build_doctor accept as files_ref. No inputs.","read_only":true},{"name":"build_get_bundle","title":"Build: Get Bundle","description":"Returns the current (or a given version's) published bundle: the file list and a signed download_url, or one file's content with file=. Inputs: project_uuid, optional version_uuid, file, offset, max_bytes. A file= answer carries the file's byte count and sha256, so a cut or empty read can be detected; files over ~20KB are read in pages (offset, max_bytes=20000, then next_offset until more is false","read_only":true},{"name":"build_deploy","title":"Build: Deploy","description":"Deploys a published version. Inputs: project_uuid, optional version_uuid, target, app_type. target='cloud_ephemeral' (managed Cloud Run preview of about 30 minutes; requires platform enablement; the default when cloud deploy is enabled) or 'local' (returns the bundle to run with the project's own key, for a local check). Returns the URL or a poll_url for build_deploy_status. A permanent public URL","read_only":false},{"name":"build_deploy_status","title":"Build: Deploy Status","description":"Returns the state of a cloud deploy started by build_deploy or build_go_live. Input: the poll_url it returned (optional permanent). Reports elapsed_s since launch. 'launching' for 5-6.5 minutes is normal while Cloud Run IAM propagates; once a url appears, any app response means it is up and a Cloud Run 403 means it is still propagating. Only an app still unreachable after about ten minutes is a re","read_only":true},{"name":"build_logs","title":"Build: Logs","description":"Returns recent Cloud Run logs of a project's deployed app: startup-probe timeouts, tracebacks, 'container failed to start on PORT'. Inputs: project_uuid, optional lines, since. Read-only; rate-limited per domain. For an error Supero itself returned (HTTP 401/403/404/409/402/422/429/5xx), error={status, message, error_code, correlation_id} adds error_explained (what it means and what resolves it). ","read_only":true},{"name":"build_go_live","title":"Build: Go Live","description":"Promotes a published version to a permanent public URL at <service>.supero.live (managed Cloud Run), unlike the ~30-minute preview of build_deploy. Inputs: project_uuid, optional version_uuid / file_id (default: the latest published version) and acknowledge_findings. Returns public_url and poll_url for build_deploy_status. Reports the latest build_audit and build_verify results. Requires a domain-","read_only":false},{"name":"build_teardown","title":"Build: Teardown","description":"Destructive: stops a project's deployments, both the permanent build_go_live app and the preview, deleting the managed Cloud Run services and freeing their URLs. Input: project_uuid. Idempotent: nothing deployed returns stopped=true. Manages only Supero-hosted apps; a project deployed to its own AWS/GCP is refused. Returns `stopped`; stopped=false means the teardown was incomplete and the app may ","read_only":false},{"name":"build_go_production","title":"Build: Go Production","description":"Takes a live app's sample data and demo logins out before real customers use it, with the same six steps as the app's Settings -> Go to production: 1. stop sample data coming back ('seed_off'; the app redeploys); 2. preview ('plan', then 'plan_status': what will be hidden or kept and why, which demo logins get locked, which accounts need a new password); 3. hide ('hide', reversible; poll 'job'); 4","read_only":false},{"name":"build_list_capabilities","title":"Build: List Capabilities","description":"Lists the services and integrations in the live platform catalog (email, sms, slack, ai, stripe_checkout, google_oauth, push_notification, ...). Returns each one's exact service_id as config.py uses it (for example 'stripe_checkout', not 'stripe'), its category, whether it needs a key, and this connection's can_import / can_configure permissions. Optional service_id returns that service's config f","read_only":true},{"name":"build_recommend_integrations","title":"Build: Recommend Integrations","description":"Recommends provider integrations for an app, with reasons. Inputs: the app description and the platform service_ids it uses (for example ['cart','order']), plus optional region, project_uuid and google_signin. Returns grouped suggestions tiered required / recommended / optional with a default option, drawn only from the installed manifests (for example cart checkout needs a payment gateway; remind","read_only":true},{"name":"build_configure_services","title":"Build: Configure Services","description":"Stores a service's keys for the project so an integration works at deploy (for example SendGrid for email, a Stripe test key for checkout). Inputs: project_uuid, service_id, config. Accepts test or sandbox keys only: keys with a clear live marker (Stripe sk_live_..., Razorpay rzp_live_...) are refused, and since most providers give no test-versus-live signal, production secrets belong in the admin","read_only":false},{"name":"build_import_services","title":"Build: Import Services","description":"Imports platform services into a project (for example 'workflows', 'email', 'stripe_checkout', 'cart', 'order', 'payment') so the app can call them and its event-bound workflows can run, using this connection's credential. Inputs: project_uuid, service_ids. Returns each service's exact outcome: imported, already imported, or failed with the platform's reason (schema_drift, schemas_failed, error_co","read_only":false},{"name":"build_doctor","title":"Build: Doctor","description":"Pre-publish checks for problems build_validate does not catch: the #supero-preloader not removed (app stuck on a spinner), heavy startup seed (Cloud Run port-bind timeout), reserved field names such as status/state (dropped), namespace collisions, and services that need elevated import permission. Inputs: project_uuid and the files (files, files_b64gz or files_ref). Returns findings with fixes. Us","read_only":true},{"name":"build_audit","title":"Build: Audit","description":"Static security and correctness audit of a bundle (the code is not executed). Finds MONEY-01 client-chosen checkout amounts, AUTHZ-01 end users able to write server-owned fields (paid/issued/status/amount/payment refs) or create tickets and payments, FLOW-01 fulfilment in the browser or on payment_status alone, INV-01 capacity or stock without server-side enforcement, PUB-01 draft or hidden rows i","read_only":true},{"name":"build_verify","title":"Build: Verify","description":"Acceptance test of the project's running preview (after build_deploy, before build_go_live), using it as a buyer would with throwaway test accounts (verify-<rand>@example.com, deleted afterwards). Checks: health (serves the published app.js, boots, API reachable); accounts (sign-up, login, forgot password); the role permission matrix (declared policy holds, server-owned fields such as status, tota","read_only":false},{"name":"build_smoke_test","title":"Build: Smoke Test","description":"HTTP-checks a deployed app: the root loads with a title, app.js is the published bundle and dismisses the boot splash, and config.js has the project's namespace; optionally signs in and reads one entity. Inputs: project_uuid and url= (from build_deploy_status) or poll_url=, plus optional email, password, tenant, entity. Returns pass/fail per check. Useful after each deploy.","read_only":false},{"name":"build_e2e_test","title":"Build: E2E Test","description":"Starts the full behavioural test suite against a published bundle in the project's own deployed app (no throwaway project): auth, RBAC and multi-tenancy, CRUD round-trips, workflows and events, services, aggregates and a real-browser UI pass. On a dev project the write suites create and delete only their own test records; a live project runs read-only suites only. Takes ~2-4 min of compute, so it ","read_only":false},{"name":"build_e2e_test_status","title":"Build: E2E Test Status","description":"Returns the state of a build_e2e_test run (input: run_id). While running: status only. When complete: the verdict (not 'healthy' if a core suite could not run), per-suite pass/fail/warn/skip, findings with the responsible layer and a fix hint, what was and was not covered, and which findings belong to the app versus the platform. A failed run carries its cause.","read_only":true},{"name":"build_list_data_sources","title":"Build: List Data Sources","description":"Lists the external data source types an app can connect to: its own Postgres, MySQL, MSSQL, Oracle or MongoDB, any REST API, or a Snowflake, BigQuery, Redshift, Databricks, ClickHouse or Fabric warehouse, plus the curated public-API catalog. No inputs. Flow: build_connect_data_source → build_discover_source → build_bind_data_source. Reference: build_get_skills(doc='connectors').","read_only":true},{"name":"build_connect_data_source","title":"Build: Connect Data Source","description":"Creates a data connector to an external source the app owner controls (a database, a REST API or a warehouse). Inputs: name, kind, and the connection fields for that kind (db_type, host, port, database, username, password, ssl_mode, or base_url, endpoint, auth), plus optional table_names, config, schema_namespace, test_first, project_uuid. Returns a connector_id; schemas are not bound yet. table_n","read_only":false},{"name":"build_discover_source","title":"Build: Discover Source","description":"Runs discovery on a connector and returns its source streams (names, columns, primary keys), AI-inferred Supero schemas, field mappings and a suggested namespace. Inputs: connector_id, optional execution_id, timeout. Runs between build_connect_data_source and build_bind_data_source; a live bind's source has to equal a discovered stream name.","read_only":false},{"name":"build_bind_data_source","title":"Build: Bind Data Source","description":"Binds source streams to the app's schemas. Inputs: connector_id, bindings. mode='live_read' (default: read-only own database or warehouse), 'live_readwrite' (own database read+write, domain-admin only) or 'sync' (copy into SuperoDB). Modes by source: postgresql, supabase and mysql take all three; mssql takes sync and live_read; oracle and mongodb take sync only; a REST api takes sync and live_read","read_only":false},{"name":"build_run_data_source","title":"Build: Run Data Source","description":"Starts a sync run on a data connector and returns the run id. Input: connector_id. Connectors created over MCP are manual-trigger, so a mode='sync' binding copies no rows until a run executes (after build_bind_data_source, and again when the source changes). Live-read and warehouse bindings read the source directly and need no run.","read_only":false},{"name":"build_list_bound_schemas","title":"Build: List Bound Schemas","description":"Classifies a project's schemas as connector-backed or app-authored, with each one's access mode (sync | live-ro | live-rw | warehouse). Input: optional project_uuid. Useful when authoring UI: read-only live sources (live-ro, warehouse) take no create or edit controls, and connector-discovered schemas are not regenerated.","read_only":true},{"name":"build_report","title":"Build: Report","description":"Read-only hand-off for a deployed project, compiled from what the server knows: what was built (from the published bundle), the app URL and expiry, console links, the demo-account table, the latest check results for this version (validate, doctor, audit, smoke, verify, e2e; a missing run is listed as not run, with the reason), open items and next steps. Inputs: project_uuid, optional version_uuid.","read_only":true},{"name":"build_production_status","title":"Build: Production Status","description":"Read-only view of a project's Go to production state; it changes nothing. Inputs: project_uuid and what: 'status' (the default: the sample data setting, the current job, blockers and the next step), 'plan' with plan_id (a preview made by build_go_production action 'plan'), 'job' with job_id (progress of a hide, unhide or delete) or 'backup' with job_id (whether a backup exists; it is downloadable ","read_only":true},{"name":"crud_search","title":"Search Objects","description":"Searches or lists objects of one type in the current domain. Inputs: object_type, optional filters / filter, sort, limit, offset, tenant. Returns matching rows. System types: project, tenant, user_account, api_key, connector, audit_log, schema_registry, client_sdk, connector_execution, connector_plugin; domain types vary per domain (schema_list shows them).","read_only":true},{"name":"crud_get","title":"Get Object","description":"Returns one object by UUID from the current domain. Inputs: object_type, uuid.","read_only":true},{"name":"crud_create","title":"Create Object","description":"Creates an object in the current domain. Inputs: object_type, name, optional parent_type, parent_fq_name, data, tenant. Returns the created object. schema_list shows the types and their fields.","read_only":false},{"name":"crud_update","title":"Update Object","description":"Updates fields of an existing object in the current domain. Inputs: object_type, uuid, data, optional tenant. Returns the updated object.","read_only":false},{"name":"crud_delete","title":"Delete Object","description":"Deletes an object from the current domain. Inputs: object_type, uuid, optional tenant. The deletion is permanent.","read_only":false},{"name":"schema_list","title":"Schema: List","description":"Lists the schemas in the current domain. No inputs.","read_only":true},{"name":"schema_get","title":"Schema: Get","description":"Returns a schema's full definition by schema_uuid, including all attributes and metadata (include_content for the content).","read_only":true},{"name":"schema_validate","title":"Schema: Validate","description":"Validates schemas without saving them: conflicts with existing schemas, circular dependencies, reserved names and parent_type. Input: schemas. Returns errors and warnings. Useful before schema_save.","read_only":true},{"name":"schema_save","title":"Schema: Save","description":"Saves schemas into a project, validating them first and linking them to the project. Returns the saved schemas with their UUIDs; skipped schemas carry the platform's reason. \n\nInput format: flat schema objects in `schemas` (not wrapped in schema_content); the tool detects the schema type and wraps it. \n\nRequired fields: name, namespace, parent_type, attributes. namespace is the app's namespace (e.","read_only":false},{"name":"schema_delete","title":"Schema: Delete","description":"Deletes a schema from the domain by schema_uuid (optional force_delete). Records of that type stop being reachable through it.","read_only":false},{"name":"schema_list_project","title":"Schema: List Project","description":"Lists the schemas linked to a project (optional project_uuid, include_content).","read_only":true},{"name":"schema_update","title":"Schema: Update","description":"Updates an existing schema definition. Inputs: schema_uuid, schema_content, optional new_version, check_compatibility. Returns the updated schema.","read_only":false},{"name":"project_link_schemas","title":"Link Schemas to Project","description":"Links existing schemas to a project, by schema_uuids or schema_names. Input: project_uuid. Returns the linked schemas.","read_only":false},{"name":"sdk_generate","title":"SDK: Generate","description":"Generates client SDKs for the domain's schemas (optional languages, force_rebuild, include_docs). Returns a request_id for sdk_status.","read_only":false},{"name":"sdk_status","title":"SDK: Status","description":"Returns the status of an SDK generation request (input: request_id).","read_only":true},{"name":"sdk_list","title":"SDK: List","description":"Lists the SDKs available for the current domain (optional language, limit).","read_only":true},{"name":"sdk_download","title":"SDK: Download","description":"Returns a download URL for an SDK (inputs: sdk_uuid, optional artifact).","read_only":true},{"name":"rbac_get_my_access","title":"RBAC: Get My Access","description":"Returns the current user's role, permissions and scope. No inputs.","read_only":true},{"name":"rbac_check_permission","title":"RBAC: Check Permission","description":"Checks whether the current user has a given permission (input: permission). Returns true or false with the reason.","read_only":true},{"name":"apikey_get_scope","title":"Get API Key Scope","description":"Returns the scope and permissions of the current API key. No inputs.","read_only":true},{"name":"connector_run","title":"Connector: Run","description":"Starts a manual sync run of a connector (connector_id, optional params).","read_only":false},{"name":"connector_cancel","title":"Connector: Cancel","description":"Cancels a running connector execution (connector_id, execution_id).","read_only":false},{"name":"connector_status","title":"Connector: Status","description":"Returns a connector's status and recent executions (connector_id).","read_only":true},{"name":"connector_enable","title":"Connector: Enable","description":"Enables a connector for scheduled runs (connector_id).","read_only":false},{"name":"connector_disable","title":"Connector: Disable","description":"Disables a connector's scheduled runs (connector_id).","read_only":false},{"name":"connector_discover","title":"Connector: Discover","description":"Starts schema and metadata discovery for a connector (connector_id, optional params). Returns an execution_id for connector_discover_status.","read_only":false},{"name":"connector_discover_status","title":"Connector: Discover Status","description":"Returns the status of a discovery execution (connector_id, execution_id).","read_only":true},{"name":"connector_discover_results","title":"Connector: Discover Results","description":"Returns the results of a discovery execution (connector_id, execution_id).","read_only":true},{"name":"connector_test_config","title":"Connector: Test Config","description":"Tests a connector configuration before it is saved (input: config). Returns whether the source is reachable with it.","read_only":false},{"name":"connector_test","title":"Connector: Test","description":"Tests an existing connector's connectivity (connector_id).","read_only":true},{"name":"connector_plugins","title":"Connector: Plugins","description":"Lists the available connector plugins. No inputs.","read_only":true}],"server_info":{"name":"supero","version":"2.1.0"},"category":"automation","tags":["project","agents","cloud"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-06","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-supero-platform-supero/"}