Server definition

Hash: sha256:0b8849a48ac59461c02f8fc652fc3c9839451b0086fbfc0aba8138d55a107826
What it is: What a remote MCP server returned when asked what it offers: 64 tools

The blob, as servednamed by its sha256

{
  "instructions": "You are connected to the Supero Platform MCP server without credentials. Tools, resources and prompts require authentication: send an API key as X-API-Key, or a JWT as Authorization: Bearer. Create a key at https://app.supero.dev under your project's API keys. See https://docs.supero.dev/developers/mcp/overview.",
  "tools": [
    {
      "description": "Get the scope and permissions of the current API key.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "apikey_get_scope",
      "outputSchema": null
    },
    {
      "description": "Bind source streams to the app's schemas. mode='live_read' (default: read-only BYODB / warehouse), 'live_readwrite' (BYODB read+write — DOMAIN-ADMIN only), or 'sync' (copy into SuperoDB). For live modes, discovery must have run and each binding's `source` must match a discovered stream; the bind VERIFIES the live mapping materialized. Bound live schemas are read/written via ORDINARY app CRUD — nothing goes in the bundle.",
      "inputSchema": {
        "properties": {
          "bindings": {
            "items": {
              "properties": {
                "mode": {
                  "enum": [
                    "live_read",
                    "live_readwrite",
                    "sync"
                  ],
                  "type": "string"
                },
                "schema": {
                  "description": "App schema name to back.",
                  "type": "string"
                },
                "source": {
                  "description": "Source stream/table (must match a discovered stream for live modes).",
                  "type": "string"
                },
                "stream_class": {
                  "description": "'entity' = mutable business records (current-state rows, e.g. customers/products); 'event' = append-only time-series/log rows (e.g. clicks, sensor readings). OMIT it to let the platform classify safely from the stream's shape — only set it to override.",
                  "enum": [
                    "entity",
                    "event"
                  ],
                  "type": "string"
                },
                "tenant_binding": {
                  "description": "How live rows map to Supero tenants. OMIT for the default {mode:'fixed', tenant:'default-tenant'} (all rows visible to the default tenant/admin — required, else live reads 403 tenant_binding_missing). For per-tenant isolation pass {mode:'column', tenant_field:'<col>', tenant_value_map:{<supero_tenant>:<source_value>}}.",
                  "type": "object"
                }
              },
              "required": [
                "schema",
                "source"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "connector_id": {
            "type": "string"
          }
        },
        "required": [
          "connector_id",
          "bindings"
        ],
        "type": "object"
      },
      "name": "build_bind_data_source",
      "outputSchema": null
    },
    {
      "description": "Configure a service's keys for the project so an integration works at deploy (e.g. wire SendGrid for email, a Stripe TEST key for checkout). TEST/SANDBOX keys ONLY. Keys with a clear live marker (Stripe sk_live_… / Razorpay rzp_live_…) are auto-refused, but most providers give NO test-vs-live signal — so for EVERY provider send test/sandbox keys only and use the admin panel for production secrets (a deep link is returned). Never put a real secret through this tool/chat. Reacts to the live permission result; secret values are never echoed.",
      "inputSchema": {
        "properties": {
          "config": {
            "description": "Test/sandbox config key→value (e.g. {\"sendgrid_api_key\":\"SG.test…\"}). Live-marked keys refused; send test keys only.",
            "type": "object"
          },
          "project_uuid": {
            "type": "string"
          },
          "service_id": {
            "description": "Catalog id (e.g. 'stripe_checkout', 'email').",
            "type": "string"
          }
        },
        "required": [
          "project_uuid",
          "service_id",
          "config"
        ],
        "type": "object"
      },
      "name": "build_configure_services",
      "outputSchema": null
    },
    {
      "description": "Create a data connector to an EXTERNAL source the app owner controls (their own database, a REST API, or a warehouse). Returns a connector_id. Does NOT bind schemas yet — run build_discover_source then build_bind_data_source. Credentials are sent to the platform and NEVER echoed back; prefer read-only DB creds / the Key Store for production. Requires a domain- or project-admin API key.",
      "inputSchema": {
        "properties": {
          "auth": {
            "description": "api kind: {type: none|api_key|bearer|basic|oauth2, ...}.",
            "type": "object"
          },
          "base_url": {
            "description": "api kind: API base URL.",
            "type": "string"
          },
          "config": {
            "description": "Extra source config (e.g. warehouse account).",
            "type": "object"
          },
          "database": {
            "type": "string"
          },
          "db_type": {
            "description": "database/warehouse: postgresql|mysql|mssql|oracle|mongodb|snowflake|bigquery|redshift|databricks|clickhouse|fabric.",
            "type": "string"
          },
          "endpoint": {
            "description": "api kind: endpoint path.",
            "type": "string"
          },
          "host": {
            "type": "string"
          },
          "kind": {
            "description": "Source kind.",
            "enum": [
              "database",
              "api",
              "warehouse"
            ],
            "type": "string"
          },
          "name": {
            "description": "Connector name (unique within the project).",
            "type": "string"
          },
          "password": {
            "description": "DB password — sent to the platform, never echoed.",
            "type": "string"
          },
          "port": {
            "type": "integer"
          },
          "schema_namespace": {
            "description": "Namespace for schemas from this source.",
            "type": "string"
          },
          "ssl_mode": {
            "type": "string"
          },
          "test_first": {
            "description": "Probe connectivity before creating (default true).",
            "type": "boolean"
          },
          "username": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "kind"
        ],
        "type": "object"
      },
      "name": "build_connect_data_source",
      "outputSchema": null
    },
    {
      "description": "Create a NEW project (domain-admin keys only; plan-gated). Mints the project's schema_namespace + an API key (returned ONCE). Use for a fresh app.",
      "inputSchema": {
        "properties": {
          "description": {
            "description": "Optional: what the app is for — persisted on the project so future sessions build to it.",
            "type": "string"
          },
          "display_name": {
            "type": "string"
          },
          "name": {
            "description": "Project name/slug.",
            "type": "string"
          },
          "requirements": {
            "description": "Optional: the confirmed requirements/plan bullets — persisted on the project record (future sessions read them via build_get_project).",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "schema_namespace": {
            "description": "Optional; server normalizes/derives if omitted.",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "name": "build_create_project",
      "outputSchema": null
    },
    {
      "description": "Deploy a published version. target='cloud_ephemeral' (managed Cloud Run, ~30m throwaway preview; requires platform enablement; the default when cloud deploy is enabled) or 'local' (hand the user the bundle to run with the project's own key). For a PERMANENT public URL, use build_go_live instead.",
      "inputSchema": {
        "properties": {
          "app_type": {
            "description": "Default 'web'.",
            "enum": [
              "web",
              "all"
            ],
            "type": "string"
          },
          "project_uuid": {
            "type": "string"
          },
          "target": {
            "description": "Default 'cloud_ephemeral' when cloud deploy is enabled (else 'local').",
            "enum": [
              "local",
              "cloud_ephemeral"
            ],
            "type": "string"
          },
          "version_uuid": {
            "description": "Default: latest published version.",
            "type": "string"
          }
        },
        "required": [
          "project_uuid"
        ],
        "type": "object"
      },
      "name": "build_deploy",
      "outputSchema": null
    },
    {
      "description": "Poll a cloud deploy started by build_deploy or build_go_live. Pass the poll_url it returned. Reports elapsed_s since launch; a launch still pending after ~5 minutes should be treated as failed.",
      "inputSchema": {
        "properties": {
          "permanent": {
            "description": "Set true when polling a build_go_live (permanent) deploy so the expiry guidance is correct. Default: auto-detected.",
            "type": "boolean"
          },
          "poll_url": {
            "type": "string"
          }
        },
        "required": [
          "poll_url"
        ],
        "type": "object"
      },
      "name": "build_deploy_status",
      "outputSchema": null
    },
    {
      "description": "Discover a connector's schema: trigger discovery, wait, and return the source streams (names, columns, primary keys), AI-inferred Supero schemas, field mappings, and a suggested namespace. Run AFTER build_connect_data_source and BEFORE build_bind_data_source (a live bind's `source` MUST equal a discovered stream name).",
      "inputSchema": {
        "properties": {
          "connector_id": {
            "type": "string"
          },
          "execution_id": {
            "description": "RESUME polling an in-flight discovery (from a previous timeout error) instead of starting a new job.",
            "type": "string"
          },
          "timeout": {
            "description": "Max seconds to wait IN THIS CALL (default 60, cap 90 — an MCP call must finish under the ~100s edge limit). On timeout, resume with the returned execution_id; the job keeps running server-side.",
            "type": "integer"
          }
        },
        "required": [
          "connector_id"
        ],
        "type": "object"
      },
      "name": "build_discover_source",
      "outputSchema": null
    },
    {
      "description": "PREFLIGHT a bundle BEFORE publish/deploy — catches the silent deploy-killers build_validate does NOT: missing #supero-preloader removal (app stuck on a spinner forever), heavy startup seed (Cloud Run port-bind timeout → 'container failed to start'), reserved field names like status/state (silently dropped), namespace collisions (ambiguous reads), and services needing elevated import permission. Run it after build_validate and before build_publish.",
      "inputSchema": {
        "properties": {
          "files": {
            "description": "Map of {relative_path: file_content}.",
            "type": "object"
          },
          "files_b64gz": {
            "description": "Alt to files: base64(gzip(JSON {path:content})).",
            "type": "string"
          },
          "files_ref": {
            "description": "For a LARGE bundle that exceeds the model output-token cap: a file_id from build_stage_bundle (upload the gzip(json {path:content}) blob out-of-band, then pass its file_id here). Preferred over files/files_b64gz when the bundle will not fit inline.",
            "type": "string"
          },
          "project_uuid": {
            "description": "Target project (enables namespace + collision checks).",
            "type": "string"
          }
        },
        "required": [
          "files"
        ],
        "type": "object"
      },
      "name": "build_doctor",
      "outputSchema": null
    },
    {
      "description": "Run the FULL behavioural test suite against a PUBLISHED bundle in the project's OWN already-deployed app (no throwaway project is created) — auth/RBAC/multi-tenant, CRUD round-trips, workflows + event emission, services, aggregates, real-browser UI. WRITE-SAFE: on a DEV project the write suites create + delete only their OWN test records (your real data stays read-only); a LIVE project is auto-restricted to read-only suites so production data is never mutated. This is the deep complement to build_smoke_test ('loads + reads one row'); it proves the app actually WORKS. COSTS A FULL RUN (~2-4 min of real compute) — a PRE-DELIVERY gate, NOT a per-edit check; run it after build_validate + build_doctor pass, on a deployed + seeded project. ASYNC: returns a run_id; poll build_e2e_test_status. Findings are layer-attributed so you know which are yours to fix (app/config) vs. report (platform/sdk). Requires platform enablement.",
      "inputSchema": {
        "properties": {
          "live_email": {
            "description": "Actually send a test email (default false → audit-only).",
            "type": "boolean"
          },
          "project_uuid": {
            "description": "The project the published bundle belongs to.",
            "type": "string"
          },
          "suites": {
            "description": "Subset to run (default ['all']). Skipping a core suite caps the verdict.",
            "items": {
              "enum": [
                "auth",
                "crud",
                "services",
                "aggregates",
                "workflows",
                "ui",
                "all"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "version_uuid": {
            "description": "Published version to test. Default: latest.",
            "type": "string"
          }
        },
        "required": [
          "project_uuid"
        ],
        "type": "object"
      },
      "name": "build_e2e_test",
      "outputSchema": null
    },
    {
      "description": "Poll an e2e run started by build_e2e_test. While running, returns status only. When complete, returns a compact report: verdict (honest — never 'healthy' if a core suite couldn't run), per-suite pass/fail/warn/skip, findings with layer + fix hint, what was/wasn't covered, and next_steps that say which findings to fix vs. report. On failure it carries a cause.",
      "inputSchema": {
        "properties": {
          "run_id": {
            "description": "The run_id from build_e2e_test.",
            "type": "string"
          }
        },
        "required": [
          "run_id"
        ],
        "type": "object"
      },
      "name": "build_e2e_test_status",
      "outputSchema": null
    },
    {
      "description": "Fetch the CURRENT (or a given) PUBLISHED bundle: the file list + a signed download_url, or ONE file's content inline via file=. For ANY change request on an existing app, START from this bundle and modify it — re-authoring from scratch silently drops the hand-authored ui/app.js and every prior fix.",
      "inputSchema": {
        "properties": {
          "file": {
            "description": "Optional app-root-relative path (e.g. 'ui/app.js') to return that single file's content inline (~120KB cap, truncated with a note).",
            "type": "string"
          },
          "project_uuid": {
            "type": "string"
          },
          "version_uuid": {
            "description": "Default: latest published version.",
            "type": "string"
          }
        },
        "required": [
          "project_uuid"
        ],
        "type": "object"
      },
      "name": "build_get_bundle",
      "outputSchema": null
    },
    {
      "description": "Fetch a COMPLETE, production-quality reference app (schemas.py + config.py + setup.py + ui/app.js) to copy patterns from — the single biggest lever for app quality. archetype='index' (default) lists the available archetypes with per-file byte sizes; pick the one closest to your app ('commerce-marketplace' | 'service-booking' | 'ops-dashboard' | 'multitenant-portal' | 'saas-billing') and fetch it BEFORE authoring your UI. These are real 'stunning' apps; mirror how they compose the SDK components, art-direct the landing page, and structure schemas. Optional file= to fetch just one file ('schemas.py' | 'config.py' | 'setup.py' | 'ui/app.js'). Responses are PAGED (~32KB/section): when the header says more:true, fetch the next section with offset=<next_offset> — never re-fetch from 0.",
      "inputSchema": {
        "properties": {
          "archetype": {
            "description": "Which reference app (default 'index' to list them).",
            "enum": [
              "index",
              "commerce-marketplace",
              "service-booking",
              "ops-dashboard",
              "multitenant-portal",
              "saas-billing"
            ],
            "type": "string"
          },
          "file": {
            "description": "Optional: return only this one file instead of the whole bundle.",
            "enum": [
              "schemas.py",
              "config.py",
              "setup.py",
              "ui/app.js"
            ],
            "type": "string"
          },
          "max_bytes": {
            "description": "Max bytes to return per section (default ~32000).",
            "type": "integer"
          },
          "offset": {
            "description": "Byte offset to start from (for paging; default 0).",
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "build_get_examples",
      "outputSchema": null
    },
    {
      "description": "Get one project's details: schema_namespace (use this EXACT value as the `namespace` literal on every schema dict), last published version, AND the captured `project_intent` — the brief (project_description/summary), the discovered data model (entities/central_entity/relationships/status_workflows), and the landing intent (public_landing_view). BUILD TO THIS — it's the authoritative app spec the user already gave; don't re-ask or ignore it.",
      "inputSchema": {
        "properties": {
          "project_uuid": {
            "description": "Project UUID (from build_list_projects).",
            "type": "string"
          }
        },
        "required": [
          "project_uuid"
        ],
        "type": "object"
      },
      "name": "build_get_project",
      "outputSchema": null
    },
    {
      "description": "Fetch the AUTHORITATIVE contract for a transactional/stateful 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). Returns the service's state machine (initial_state + transitions), its operations (op ids + input fields + resulting state), the base schemas + mandatory fields you must supply, AND the platform's DEFAULT UI SCHEMAS for that service — the bulletproof reference for building a correct, sophisticated transactional UI. ALWAYS call this for any service your app `extends` BEFORE authoring its UI — do not guess op names, states, or mandatory fields from prose. service_id='index' (default) lists all services.",
      "inputSchema": {
        "properties": {
          "parts": {
            "description": "What to return (default 'both'): 'contract' = state machine/ops/schemas; 'ui_schemas' = default UI only.",
            "enum": [
              "both",
              "contract",
              "ui_schemas"
            ],
            "type": "string"
          },
          "service_id": {
            "description": "The service id (e.g. 'cart', 'booking', 'payment'); 'index' (default) lists all.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "build_get_service_contract",
      "outputSchema": null
    },
    {
      "description": "Fetch a Supero build reference. doc='skills' (default, the spec you MUST follow) | 'components' (the real pre-built SDK component/global catalog — read so you don't reinvent UI) | 'rubric' (the rich-app quality checklist — what 'stunning' means) | 'landing' (compact landing-page derivation + quality bar — MANDATORY read for public-facing apps) | 'integrations' (the EXACT services.* wrapper→service_id→args map for email/sms/stripe/ai/etc.) | 'web' / 'transactional' / 'workflows' / 'mobile' / 'services' (deep companion docs) | 'e2e_testing'. Returns the doc + a content version + the SDK floor to pin. Read 'skills' FIRST, then 'components' + a matching build_get_examples before you author UI. Docs are PAGED (~32KB/section): when the header says more:true, fetch the next section with offset=<next_offset> — never re-fetch from 0.",
      "inputSchema": {
        "properties": {
          "doc": {
            "description": "Which doc (default 'skills').",
            "enum": [
              "skills",
              "components",
              "rubric",
              "landing",
              "integrations",
              "web",
              "transactional",
              "workflows",
              "mobile",
              "services",
              "e2e_testing",
              "connectors"
            ],
            "type": "string"
          },
          "max_bytes": {
            "description": "Max bytes to return per section (default ~32000).",
            "type": "integer"
          },
          "offset": {
            "description": "Byte offset to start from (for paging large docs; default 0).",
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "build_get_skills",
      "outputSchema": null
    },
    {
      "description": "PERMANENT deploy: promote a published version to a PERMANENT public URL at <service>.supero.live (managed Cloud Run) — unlike build_deploy(target='cloud_ephemeral'), which is a ~30-min throwaway. If version_uuid/file_id are omitted, the latest published version for the project is used. Returns public_url + poll_url; poll with build_deploy_status until live, then build_smoke_test the public_url. build_teardown removes it. Requires a domain- or project-admin API key + platform cloud-deploy enablement.",
      "inputSchema": {
        "properties": {
          "file_id": {
            "description": "Default: the resolved version's web artifact file_id.",
            "type": "string"
          },
          "project_uuid": {
            "type": "string"
          },
          "version_uuid": {
            "description": "Default: latest published version.",
            "type": "string"
          }
        },
        "required": [
          "project_uuid"
        ],
        "type": "object"
      },
      "name": "build_go_live",
      "outputSchema": null
    },
    {
      "description": "Classify this project's schemas: which are connector-backed vs app-authored, and each one's access mode (sync | live-ro | live-rw | warehouse). Use it so you DON'T render create/edit UI for read-only live sources (live-ro/warehouse) or regenerate/overwrite connector-discovered schemas.",
      "inputSchema": {
        "properties": {
          "project_uuid": {
            "description": "Defaults to the key's project.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "build_list_bound_schemas",
      "outputSchema": null
    },
    {
      "description": "List the platform's available services/integrations from the LIVE catalog (email, sms, slack, ai, stripe_checkout, google_oauth, push_notification, …) — so the intake's 'which connections/integrations?' question is accurate and you never guess a service id. Returns each service's exact catalog `service_id` (use it verbatim in config.py `services` — e.g. 'stripe_checkout', NOT 'stripe'), category, whether it needs a key, and YOUR connection's service permissions (can_import / can_configure). Descriptive — what EXISTS, never what to use. Pass service_id for one service's config fields.",
      "inputSchema": {
        "properties": {
          "category": {
            "description": "Optional filter ('integration' or 'service').",
            "type": "string"
          },
          "service_id": {
            "description": "Optional: one service's detail incl. config fields.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "build_list_capabilities",
      "outputSchema": null
    },
    {
      "description": "List the external DATA SOURCE types an app can connect to — its own Postgres/MySQL/MSSQL/Oracle/MongoDB, any REST API, or a Snowflake/BigQuery/Redshift/Databricks/ClickHouse/Fabric warehouse — plus the curated public-API catalog. Read this to offer a 'connect your own data' option. Flow: build_connect_data_source → build_discover_source → build_bind_data_source. See build_get_skills(doc='connectors').",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "build_list_data_sources",
      "outputSchema": null
    },
    {
      "description": "List projects you can build into (uuid, name, schema_namespace, live_url).",
      "inputSchema": {
        "properties": {
          "limit": {
            "description": "Max results (default 50).",
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "build_list_projects",
      "outputSchema": null
    },
    {
      "description": "Fetch recent Cloud Run logs for a project's deployed app — THE tool for diagnosing a failed/stalled cloud deploy or a crashing app (startup-probe timeouts, tracebacks, 'container failed to start on PORT'). Read-only; rate-limited per domain.",
      "inputSchema": {
        "properties": {
          "lines": {
            "description": "Max log lines to return (default 200).",
            "type": "integer"
          },
          "project_uuid": {
            "type": "string"
          },
          "since": {
            "description": "How many minutes back to fetch (default 60).",
            "type": "integer"
          }
        },
        "required": [
          "project_uuid"
        ],
        "type": "object"
      },
      "name": "build_logs",
      "outputSchema": null
    },
    {
      "description": "PLAN FIRST — turn a one-line app idea into an explicit BUILD CHECKLIST before you author anything, so a thin prompt doesn't silently skip what expert builders add (this is exactly why first-draft apps miss detail pages, tenant pickers, seed data). Deterministic, no LLM: it detects the app's VERTICAL and returns the authentic page structure + terminology for that domain, which entities need a full DETAIL PAGE, the multi-tenant login pattern (picker + tenant=''), seed guidance, and which build_get_examples to copy. Call it right after build_get_skills and BEFORE authoring.",
      "inputSchema": {
        "properties": {
          "description": {
            "description": "The app idea in a sentence or two (e.g. 'portal for Karnataka polytechnic colleges with admin + student portals').",
            "type": "string"
          },
          "entities": {
            "description": "Optional: the main entity/noun names (e.g. ['college','course','student']). Sharpens the per-entity detail-page + seed guidance.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "is_multi_tenant": {
            "description": "Optional: true if each customer/org (college/clinic/branch) is a separate tenant. Inferred from the description if omitted.",
            "type": "boolean"
          },
          "public_facing": {
            "description": "Optional: true if end-users/the public browse it (vs an internal-only tool). Inferred if omitted.",
            "type": "boolean"
          }
        },
        "required": [
          "description"
        ],
        "type": "object"
      },
      "name": "build_plan",
      "outputSchema": null
    },
    {
      "description": "Package + upload your authored bundle and record a version under the project. Returns version_uuid + file_id + download_url. Runs build_validate first unless force=true. Provide files as {relative_path: content}.",
      "inputSchema": {
        "properties": {
          "app_type": {
            "description": "Default 'web'.",
            "enum": [
              "web",
              "all"
            ],
            "type": "string"
          },
          "files": {
            "description": "Map of {relative_path: file_content}.",
            "type": "object"
          },
          "files_b64gz": {
            "description": "Alt to files: base64(gzip(JSON {path:content})). Use if a CDN/WAF blocks raw code in the body.",
            "type": "string"
          },
          "files_ref": {
            "description": "For a LARGE bundle that exceeds the model output-token cap: a file_id from build_stage_bundle (upload the gzip(json {path:content}) blob out-of-band, then pass its file_id here). Preferred over files/files_b64gz when the bundle will not fit inline.",
            "type": "string"
          },
          "force": {
            "description": "Publish even if validation has errors (default false).",
            "type": "boolean"
          },
          "project_uuid": {
            "type": "string"
          },
          "validate": {
            "description": "Validate before publish (default true).",
            "type": "boolean"
          }
        },
        "required": [
          "project_uuid",
          "files"
        ],
        "type": "object"
      },
      "name": "build_publish",
      "outputSchema": null
    },
    {
      "description": "RECOMMEND which concrete provider integrations this app needs, and WHY — the deterministic Step-2 intelligence the web wizard uses, now over MCP. Pass the app `description` + the platform `service_ids` it will use (e.g. ['cart','order']); returns GROUPED, TIERED suggestions (required/recommended/optional) with the default option flagged — e.g. cart/checkout → a payment gateway (REQUIRED; stripe_checkout default, paypal/razorpay offered), customer-facing apps → transactional email, appointments+reminders → sms. Options are drawn ONLY from the LIVE installed manifests, so it can't suggest a provider you don't have. PRESCRIPTIVE complement to build_list_capabilities (which is descriptive): call this so you don't OMIT a needed integration; use build_list_capabilities for a service's exact id + config fields.",
      "inputSchema": {
        "properties": {
          "description": {
            "description": "The app description / intent (drives email/sms/oauth/ai/payment triggers).",
            "type": "string"
          },
          "service_ids": {
            "description": "Platform service ids the app will use (e.g. ['cart','order','appointment']). Drives most recommendations.",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "name": "build_recommend_integrations",
      "outputSchema": null
    },
    {
      "description": "DESTRUCTIVE (DOMAIN-admin keys only): completely replace a DEV-mode project's app — wipes its data (retains credentials, API keys, namespace, tenant). Refused if mode='live'. Requires confirm_project_name to match. If you pass files, they are VALIDATED before any wipe (a bad bundle is a no-op) and published after; otherwise wipe-only, then call build_publish.",
      "inputSchema": {
        "properties": {
          "app_type": {
            "enum": [
              "web",
              "all"
            ],
            "type": "string"
          },
          "confirm_project_name": {
            "description": "Must equal the project's name — a safety confirmation.",
            "type": "string"
          },
          "files": {
            "description": "Optional new bundle {path: content} to publish after the wipe.",
            "type": "object"
          },
          "files_b64gz": {
            "description": "Alt to files: base64(gzip(JSON {path:content})). Use if a CDN/WAF blocks raw code in the body.",
            "type": "string"
          },
          "files_ref": {
            "description": "For a LARGE bundle that exceeds the model output-token cap: a file_id from build_stage_bundle (upload the gzip(json {path:content}) blob out-of-band, then pass its file_id here). Preferred over files/files_b64gz when the bundle will not fit inline.",
            "type": "string"
          },
          "project_uuid": {
            "type": "string"
          }
        },
        "required": [
          "project_uuid",
          "confirm_project_name"
        ],
        "type": "object"
      },
      "name": "build_replace_project",
      "outputSchema": null
    },
    {
      "description": "Trigger a SYNC RUN on a data connector and return the run id. MCP-created connectors are trigger:manual, so a mode='sync' binding copies NO rows until a run executes — call this after build_bind_data_source (and again whenever the source data changes). Live-read/warehouse bindings don't need runs (they read the source directly).",
      "inputSchema": {
        "properties": {
          "connector_id": {
            "description": "The connector to run (from build_connect_data_source).",
            "type": "string"
          }
        },
        "required": [
          "connector_id"
        ],
        "type": "object"
      },
      "name": "build_run_data_source",
      "outputSchema": null
    },
    {
      "description": "Set a project's build mode. 'dev' (default) allows COMPLETE REPLACE (wipe data, keep credentials); 'live' protects it. Switch to dev before replacing, to live when it's in production.",
      "inputSchema": {
        "properties": {
          "mode": {
            "enum": [
              "dev",
              "live"
            ],
            "type": "string"
          },
          "project_uuid": {
            "type": "string"
          }
        },
        "required": [
          "project_uuid",
          "mode"
        ],
        "type": "object"
      },
      "name": "build_set_project_mode",
      "outputSchema": null
    },
    {
      "description": "VERIFY a DEPLOYED app actually works (not just 'running'). HTTP-checks the live URL: root loads with a title, app.js is your bundle (not a stub) and dismisses the boot splash, config.js namespace matches the project; optionally logs in and reads an entity to confirm data + no namespace ambiguity. Pass url= (from build_deploy_status) or poll_url=. THE post-deploy gate — run it after every deploy.",
      "inputSchema": {
        "properties": {
          "email": {
            "description": "Optional — a user to log in and verify data reads.",
            "type": "string"
          },
          "entity": {
            "description": "Optional bare schema slug (e.g. 'participant') to read for the authed data check.",
            "type": "string"
          },
          "expected_app_js_sha1": {
            "description": "Optional — the first 12 lowercase hex chars of `sha1sum ui/app.js` (sha1 of your local bundle FILE). If given, smoke_test reports whether the DEPLOYED app.js matches, so you can confirm the deploy actually rolled (vs a stuck roll / stale cache serving the old bundle). Case-insensitive; a malformed value is reported as a warning, never a false mismatch.",
            "type": "string"
          },
          "password": {
            "description": "Optional — password for that user.",
            "type": "string"
          },
          "poll_url": {
            "description": "Alt to url: the build_deploy poll_url; the URL is resolved from it.",
            "type": "string"
          },
          "project_uuid": {
            "description": "The deployed project (for namespace + live_url).",
            "type": "string"
          },
          "tenant": {
            "description": "Optional tenant for the login. Default '' so the server resolves the user's OWN tenant (required for a multi-tenant app whose test user lives in a named tenant).",
            "type": "string"
          },
          "url": {
            "description": "The deployed app URL (from build_deploy_status).",
            "type": "string"
          }
        },
        "required": [
          "project_uuid"
        ],
        "type": "object"
      },
      "name": "build_smoke_test",
      "outputSchema": null
    },
    {
      "description": "PUB-1a: get the out-of-band UPLOAD endpoint for a LARGE app bundle that won't fit inline (the model's max OUTPUT tokens cap `files`/`files_b64gz`, so big apps otherwise have to be truncated/minified). Upload a gzip(json {path:content}) blob to the returned URL with your OWN key, then pass the returned file_id as `files_ref` to build_validate / build_publish / build_doctor. Bundle size then no longer depends on any token cap.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "build_stage_bundle",
      "outputSchema": null
    },
    {
      "description": "Tear down a project's live deployment — BOTH the permanent (build_go_live) app and the ephemeral preview — DELETEing the managed Cloud Run services and freeing their URLs. Idempotent: a project with nothing deployed returns stopped=true. ONLY manages Supero-hosted apps — a project deployed to your own AWS/GCP is refused, not silently reported stopped. Check `stopped`: false means the teardown was INCOMPLETE and the app may still be serving (and billing) — re-run it, do not report success. Requires a domain- or project-admin API key.",
      "inputSchema": {
        "properties": {
          "project_uuid": {
            "type": "string"
          }
        },
        "required": [
          "project_uuid"
        ],
        "type": "object"
      },
      "name": "build_teardown",
      "outputSchema": null
    },
    {
      "description": "Update a project's metadata (display_name, description, show_public, live_url).",
      "inputSchema": {
        "properties": {
          "patch": {
            "description": "Fields to update.",
            "type": "object"
          },
          "project_uuid": {
            "type": "string"
          }
        },
        "required": [
          "project_uuid",
          "patch"
        ],
        "type": "object"
      },
      "name": "build_update_project",
      "outputSchema": null
    },
    {
      "description": "Validate a locally-authored bundle against the live platform BEFORE publishing. AST-only (your code is never executed). Checks manifest, syntax, import-safety, config exports, schema validity, and namespace==project schema_namespace.",
      "inputSchema": {
        "properties": {
          "files": {
            "description": "Map of {relative_path: file_content} for the bundle.",
            "type": "object"
          },
          "files_b64gz": {
            "description": "Alt to files: base64(gzip(JSON {path:content})). Use if a CDN/WAF blocks raw code in the body.",
            "type": "string"
          },
          "files_ref": {
            "description": "For a LARGE bundle that exceeds the model output-token cap: a file_id from build_stage_bundle (upload the gzip(json {path:content}) blob out-of-band, then pass its file_id here). Preferred over files/files_b64gz when the bundle will not fit inline.",
            "type": "string"
          },
          "project_uuid": {
            "description": "Target project (for namespace/schema checks).",
            "type": "string"
          }
        },
        "required": [
          "files"
        ],
        "type": "object"
      },
      "name": "build_validate",
      "outputSchema": null
    },
    {
      "description": "Resolve your API key's scope: role (domain_admin/project_admin), domain, whether you can create projects, and your plan. Call this to decide the flow.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "build_whoami",
      "outputSchema": null
    },
    {
      "description": "Cancel a running connector execution.",
      "inputSchema": {
        "properties": {
          "connector_id": {
            "description": "UUID of the connector.",
            "type": "string"
          },
          "execution_id": {
            "description": "UUID of the execution to cancel.",
            "type": "string"
          }
        },
        "required": [
          "connector_id",
          "execution_id"
        ],
        "type": "object"
      },
      "name": "connector_cancel",
      "outputSchema": null
    },
    {
      "description": "Disable a connector.",
      "inputSchema": {
        "properties": {
          "connector_id": {
            "description": "UUID of the connector.",
            "type": "string"
          }
        },
        "required": [
          "connector_id"
        ],
        "type": "object"
      },
      "name": "connector_disable",
      "outputSchema": null
    },
    {
      "description": "Trigger schema/metadata discovery for a connector.",
      "inputSchema": {
        "properties": {
          "connector_id": {
            "description": "UUID of the connector.",
            "type": "string"
          },
          "params": {
            "description": "Optional discovery parameters.",
            "type": "object"
          }
        },
        "required": [
          "connector_id"
        ],
        "type": "object"
      },
      "name": "connector_discover",
      "outputSchema": null
    },
    {
      "description": "Get discovery results.",
      "inputSchema": {
        "properties": {
          "connector_id": {
            "description": "UUID of the connector.",
            "type": "string"
          },
          "execution_id": {
            "description": "UUID of the discovery execution.",
            "type": "string"
          }
        },
        "required": [
          "connector_id",
          "execution_id"
        ],
        "type": "object"
      },
      "name": "connector_discover_results",
      "outputSchema": null
    },
    {
      "description": "Get discovery execution status.",
      "inputSchema": {
        "properties": {
          "connector_id": {
            "description": "UUID of the connector.",
            "type": "string"
          },
          "execution_id": {
            "description": "UUID of the discovery execution.",
            "type": "string"
          }
        },
        "required": [
          "connector_id",
          "execution_id"
        ],
        "type": "object"
      },
      "name": "connector_discover_status",
      "outputSchema": null
    },
    {
      "description": "Enable a connector for scheduling.",
      "inputSchema": {
        "properties": {
          "connector_id": {
            "description": "UUID of the connector.",
            "type": "string"
          }
        },
        "required": [
          "connector_id"
        ],
        "type": "object"
      },
      "name": "connector_enable",
      "outputSchema": null
    },
    {
      "description": "List available connector plugins.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "connector_plugins",
      "outputSchema": null
    },
    {
      "description": "Trigger a manual connector sync execution.",
      "inputSchema": {
        "properties": {
          "connector_id": {
            "description": "UUID of the connector.",
            "type": "string"
          },
          "params": {
            "description": "Optional execution parameters.",
            "type": "object"
          }
        },
        "required": [
          "connector_id"
        ],
        "type": "object"
      },
      "name": "connector_run",
      "outputSchema": null
    },
    {
      "description": "Get connector status and recent executions.",
      "inputSchema": {
        "properties": {
          "connector_id": {
            "description": "UUID of the connector.",
            "type": "string"
          }
        },
        "required": [
          "connector_id"
        ],
        "type": "object"
      },
      "name": "connector_status",
      "outputSchema": null
    },
    {
      "description": "Test an existing connector's connectivity.",
      "inputSchema": {
        "properties": {
          "connector_id": {
            "description": "UUID of the connector.",
            "type": "string"
          }
        },
        "required": [
          "connector_id"
        ],
        "type": "object"
      },
      "name": "connector_test",
      "outputSchema": null
    },
    {
      "description": "Test a connector configuration.",
      "inputSchema": {
        "properties": {
          "config": {
            "description": "Connector config to test.",
            "type": "object"
          }
        },
        "required": [
          "config"
        ],
        "type": "object"
      },
      "name": "connector_test_config",
      "outputSchema": null
    },
    {
      "description": "Create a new object in the current domain. Use schema_list to see available types and their fields.",
      "inputSchema": {
        "properties": {
          "data": {
            "description": "Object fields as key-value pairs",
            "type": "object"
          },
          "name": {
            "description": "Object name (required for most types)",
            "type": "string"
          },
          "object_type": {
            "description": "The object type to create (e.g. 'customer', 'appointment', 'project')",
            "type": "string"
          },
          "parent_fq_name": {
            "description": "Parent FQ name path (e.g. ['cine-corp', 'car-service'])",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "parent_type": {
            "description": "Parent type if applicable (e.g. 'project' for tenant, 'domain' for project)",
            "type": "string"
          },
          "tenant": {
            "description": "Optional tenant name to create the object under (multi-tenant apps: seed a specific named tenant's data). Omit for single-tenant apps — the session/API-key tenant is used.",
            "type": "string"
          }
        },
        "required": [
          "object_type",
          "name"
        ],
        "type": "object"
      },
      "name": "crud_create",
      "outputSchema": null
    },
    {
      "description": "Delete an object from the current domain.",
      "inputSchema": {
        "properties": {
          "object_type": {
            "description": "The object type",
            "type": "string"
          },
          "tenant": {
            "description": "Optional tenant name context for this delete (multi-tenant apps). Omit for single-tenant apps — the session/API-key tenant is used. Deletes address the record by UUID.",
            "type": "string"
          },
          "uuid": {
            "description": "Object UUID to delete",
            "type": "string"
          }
        },
        "required": [
          "object_type",
          "uuid"
        ],
        "type": "object"
      },
      "name": "crud_delete",
      "outputSchema": null
    },
    {
      "description": "Get a specific object by UUID from the current domain.",
      "inputSchema": {
        "properties": {
          "object_type": {
            "description": "The object type (e.g. 'customer', 'project', 'tenant')",
            "type": "string"
          },
          "uuid": {
            "description": "Object UUID",
            "type": "string"
          }
        },
        "required": [
          "object_type",
          "uuid"
        ],
        "type": "object"
      },
      "name": "crud_get",
      "outputSchema": null
    },
    {
      "description": "Search/list objects of any type in the current domain. Use schema_list first to discover available object types. System types: project, tenant, user_account, api_key, connector, audit_log, schema_registry, client_sdk, connector_execution, connector_plugin. Domain types vary per domain (e.g. customer, invoice, appointment, vehicle).",
      "inputSchema": {
        "properties": {
          "detail": {
            "description": "Include full object data (default: true)",
            "type": "boolean"
          },
          "filters": {
            "description": "Filter criteria as key-value pairs (e.g. {\"status\": \"active\"})",
            "type": "object"
          },
          "limit": {
            "description": "Max results (default: 100)",
            "type": "integer"
          },
          "object_type": {
            "description": "The object type to search (e.g. 'customer', 'project', 'tenant', 'connector')",
            "type": "string"
          },
          "offset": {
            "description": "Skip N results for pagination",
            "type": "integer"
          },
          "tenant": {
            "description": "Optional tenant name to scope the search to (multi-tenant apps: verify a specific named tenant's data). Omit for single-tenant apps — the session/API-key tenant is used.",
            "type": "string"
          }
        },
        "required": [
          "object_type"
        ],
        "type": "object"
      },
      "name": "crud_search",
      "outputSchema": null
    },
    {
      "description": "Update an existing object in the current domain.",
      "inputSchema": {
        "properties": {
          "data": {
            "description": "Fields to update",
            "type": "object"
          },
          "object_type": {
            "description": "The object type",
            "type": "string"
          },
          "tenant": {
            "description": "Optional tenant name context for this update (multi-tenant apps). Omit for single-tenant apps — the session/API-key tenant is used. Updates address the record by UUID.",
            "type": "string"
          },
          "uuid": {
            "description": "Object UUID to update",
            "type": "string"
          }
        },
        "required": [
          "object_type",
          "uuid",
          "data"
        ],
        "type": "object"
      },
      "name": "crud_update",
      "outputSchema": null
    },
    {
      "description": "Link schemas to a project. Accepts schema UUIDs or names.",
      "inputSchema": {
        "properties": {
          "project_uuid": {
            "description": "UUID of the project to link schemas to.",
            "type": "string"
          },
          "schema_names": {
            "description": "List of schema names to link (resolved to UUIDs).",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "schema_uuids": {
            "description": "List of schema registry UUIDs to link.",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "project_uuid"
        ],
        "type": "object"
      },
      "name": "project_link_schemas",
      "outputSchema": null
    },
    {
      "description": "Check if the current user has a specific permission.",
      "inputSchema": {
        "properties": {
          "permission": {
            "description": "Permission to check (e.g. 'schema:manage', 'data:write').",
            "type": "string"
          }
        },
        "required": [
          "permission"
        ],
        "type": "object"
      },
      "name": "rbac_check_permission",
      "outputSchema": null
    },
    {
      "description": "Get current user's role, permissions, and scope.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "rbac_get_my_access",
      "outputSchema": null
    },
    {
      "description": "Delete a schema from the domain. Use with caution.",
      "inputSchema": {
        "properties": {
          "force_delete": {
            "description": "Force delete even with dependencies (default: false).",
            "type": "boolean"
          },
          "schema_uuid": {
            "description": "UUID of the schema to delete.",
            "type": "string"
          }
        },
        "required": [
          "schema_uuid"
        ],
        "type": "object"
      },
      "name": "schema_delete",
      "outputSchema": null
    },
    {
      "description": "Get full details of a specific schema by UUID. Returns the complete schema definition including all attributes and metadata.",
      "inputSchema": {
        "properties": {
          "include_content": {
            "description": "Include full schema content (default: true).",
            "type": "boolean"
          },
          "schema_uuid": {
            "description": "UUID of the schema to retrieve.",
            "type": "string"
          }
        },
        "required": [
          "schema_uuid"
        ],
        "type": "object"
      },
      "name": "schema_get",
      "outputSchema": null
    },
    {
      "description": "List all existing schemas in the current domain.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "schema_list",
      "outputSchema": null
    },
    {
      "description": "List schemas linked to the current project.",
      "inputSchema": {
        "properties": {
          "include_content": {
            "description": "Include full schema content (default: true).",
            "type": "boolean"
          },
          "project_uuid": {
            "description": "Project to list schemas for. Optional; defaults to the key's project when resolvable (pass the project_uuid from build_whoami/build_list_projects under an API key).",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "schema_list_project",
      "outputSchema": null
    },
    {
      "description": "Save/upload schemas to the domain. Schemas are validated before saving. Returns list of successfully saved schemas with their UUIDs. \n\nIMPORTANT: Pass FLAT schema objects directly — do NOT wrap in schema_content. The tool handles schema_type detection and wrapping automatically. \n\nRequired fields: name, parent_type, prefix, plural_name, attributes, description. \n\nSupported attribute types: 'string' for text, 'float' for decimal numbers (NOT 'number'), 'integer' for whole numbers, 'boolean' for true/false. \n\nOptionally pass project_uuid to auto-link saved schemas to a project. \n\nExample:\n{\n  \"schemas\": [{\n    \"name\": \"product\",\n    \"description\": \"Product catalog entry\",\n    \"parent_type\": \"tenant\",\n    \"prefix\": \"prd\",\n    \"plural_name\": \"products\",\n    \"attributes\": [\n      {\"name\": \"title\", \"type\": \"string\", \"required\": true},\n      {\"name\": \"price\", \"type\": \"float\"},\n      {\"name\": \"stock\", \"type\": \"integer\"}\n    ]\n  }]\n}",
      "inputSchema": {
        "properties": {
          "project_uuid": {
            "description": "Optional project UUID to auto-link saved schemas to.",
            "type": "string"
          },
          "schemas": {
            "description": "Array of schema definitions to save.",
            "items": {
              "type": "object"
            },
            "type": "array"
          },
          "skip_existing": {
            "description": "Skip schemas that already exist (default: true).",
            "type": "boolean"
          }
        },
        "required": [
          "schemas"
        ],
        "type": "object"
      },
      "name": "schema_save",
      "outputSchema": null
    },
    {
      "description": "Update an existing schema definition.",
      "inputSchema": {
        "properties": {
          "check_compatibility": {
            "description": "Check compatibility with existing data (default: true).",
            "type": "boolean"
          },
          "new_version": {
            "description": "Optional new version string.",
            "type": "string"
          },
          "schema_content": {
            "description": "New schema content (full schema definition).",
            "type": "object"
          },
          "schema_uuid": {
            "description": "UUID of the schema to update.",
            "type": "string"
          }
        },
        "required": [
          "schema_uuid",
          "schema_content"
        ],
        "type": "object"
      },
      "name": "schema_update",
      "outputSchema": null
    },
    {
      "description": "Validate schemas before saving. Checks for conflicts with existing schemas, circular dependencies, reserved names, and parent_type correctness. Always validate before saving!",
      "inputSchema": {
        "properties": {
          "schemas": {
            "description": "Array of schema definitions to validate.",
            "items": {
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "schemas"
        ],
        "type": "object"
      },
      "name": "schema_validate",
      "outputSchema": null
    },
    {
      "description": "Get download URL for an SDK.",
      "inputSchema": {
        "properties": {
          "artifact": {
            "description": "Artifact type (default: 'wheel').",
            "enum": [
              "wheel",
              "source",
              "docs"
            ],
            "type": "string"
          },
          "sdk_uuid": {
            "description": "UUID of the SDK.",
            "type": "string"
          }
        },
        "required": [
          "sdk_uuid"
        ],
        "type": "object"
      },
      "name": "sdk_download",
      "outputSchema": null
    },
    {
      "description": "Generate client SDKs for the domain's schemas.",
      "inputSchema": {
        "properties": {
          "force_rebuild": {
            "description": "Force rebuild (default: false).",
            "type": "boolean"
          },
          "include_docs": {
            "description": "Include docs (default: true).",
            "type": "boolean"
          },
          "languages": {
            "description": "Languages to generate (default: ['python', 'javascript']).",
            "items": {
              "enum": [
                "python",
                "javascript",
                "java",
                "go",
                "cpp"
              ],
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "name": "sdk_generate",
      "outputSchema": null
    },
    {
      "description": "List available SDKs for the current domain.",
      "inputSchema": {
        "properties": {
          "language": {
            "description": "Filter by language.",
            "type": "string"
          },
          "limit": {
            "description": "Max results (default: 50).",
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "sdk_list",
      "outputSchema": null
    },
    {
      "description": "Check SDK generation request status.",
      "inputSchema": {
        "properties": {
          "request_id": {
            "description": "Request ID from sdk_generate.",
            "type": "string"
          }
        },
        "required": [
          "request_id"
        ],
        "type": "object"
      },
      "name": "sdk_status",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:0b8849a48ac59461c02f8fc652fc3c9839451b0086fbfc0aba8138d55a107826 | sha256sum