Topline Docs

Build MCP

Build cookbook: Example catalog

The maintained golden examples, the template each routes to, and the boundary each one keeps.

Example Catalog

Use these names as routing examples, not as promises of a new platform capability. Each starts from the smallest current template and follows the draft-only lifecycle in validation-and-lifecycle.md.

Golden exampleRoute toCore boundary
worked-walkthroughpython-apiEnd-to-end application of every skill step to one request; also the minimal single-Converse-call reference.
live-operations-dashboardmulti-source-dashboard + live SQL datasetsBounded joins/metrics and visible TTL freshness.
viewer-scoped-customer-portalviewer-scoped-dashboardSigned-in viewer; currently only customers.email row filtering.
internal-action-toolinternal-toolPrivate tool; use declared server routes and guarded workspace state only when needed.
private-api-first-apppython-apiPrivate /_artifact/api/* routes and server-side integrations.
customer-scoped-mapPlatform-service-backed UIMapLibre browser surface over a tenant-authenticated, customer-account Amazon Location Maps and Places broker; no browser credentials or implicit location writes.
FastMCP serverfastmcp-serverLive-only exact MCP ingress, platform-owned credential, and customer-managed tool review for chat/coding.
bounded-bedrock-assistantpython-apiPrivate route, one bounded Bedrock Converse call, no agentic extras.
knowledge-base-backed-appreact-dashboard + an exact published Knowledge Base grantNormal artifact reads one approved live release through relative /_artifact/knowledge/* broker routes; no token, provider ID, or direct public endpoint.
signed-webhook-boundaryPlatform service boundaryCurrent artifact routing cannot expose provider-verifiable, durable machine ingress.
cache-warmed-multi-source-dashboardmulti-source-dashboard + live datasetExplicit recurring refresh_live_cache, Redis preflight, live fallback, and visible generatedAt.
precomputed-s3-reportartifact-draft or react-dashboard + precomputed datasetPlatform-managed private object storage through declared routes; never expose object URLs.
materialized-sql-data-productmulti-source-dashboard after upstream workUpstream materialized table/view is separately owned and cataloged; app performs bounded read-only access.
customer-api-source-pipelineData Sources build + platform.connector.rest.v1The operational connector, credentials, checkpoints and tables are first-class Data Source objects; with the workspace on, scheduling it creates its data pipeline artifact.
data-pipeline-artifactBuilt-in data pipeline artifact (no template)One artifact per connector instance: tables and named schedules (including PestRoutes hard-delete schedules) in a pipelineManifest; the coder saves drafts, a person publishes.

Template choice may change if the visual surface changes, but the stated security and data boundary must not. In particular, do not use the aggregate template for multi-source math, use a precompute schedule merely as a cache warmer, or turn a webhook into a viewer-authenticated route.