Fine Structure

Get app overview: files, published state, URL, active jobs.

Return SSL/certificate status and pending certificate validation DNS records for the app custom domain.

Return the exact DNS records and instructions required to verify and route the app custom domain.

Get all entity (data model) schemas for an app, with record counts. Each entity has fields, types, and relationships.

Get recent runtime errors for an app (last 20). Useful for diagnosing issues before updating.

Poll the status of an async generation job. Use this after create_app or update_app to know when the job is done. Returns status ('running' or 'done'), progress events, and result summary when complete.

Get all pages in an app with their file paths and sizes.

Return a machine-readable Fine Structure / FSe2 guide for AI agents. Call this at the start of an MCP session to learn app files, entities, safe edit workflows, validation, publishing, A/B testing, secrets, and platform rules.

Return editor preview and published/public URLs for an app.

Return the recommended MCP tool sequence for a task type. Use this before creating apps, editing files, seeding data, publishing, setting up A/B tests, restoring versions, or configuring secrets/integrations.

Return server-side preview context: URLs, persisted runtime/network errors, static clickable candidates, pages, and explicit live-browser availability.

Provision a generated-app runtime member with a role. This does not create a Studio collaborator. The owner role cannot be assigned. If password is omitted, a temporary password is generated and returned once.

List the platform A/B tests configured for an app.

List an app's platform path, subdomain, and configured custom domain with verification, SSL, primary-domain, redirect, publish, and login-gating status.

List generated-app runtime users/members for an app. This is separate from Studio project collaborators.

List all applications owned by the authenticated user.

List supported integrations and safe connected integration metadata for an app. Tokens/secrets are never returned.

List restorable Saved Versions for an app, including versions created by MCP writes.

List secret key names for an app. Secret values are never returned.

Patch one file by replacing exact text. Safer than full overwrite for targeted edits. Creates a Saved Version before changing content.

Publish an app - freeze current state and make it live at a URL. Also configures whether the public URL is open, app-login gated, private, or inferred from the app.

Query app data records for one entity with optional exact-match filters.

Read one source file from an app's virtual filesystem.

Read several source files from an app's virtual filesystem.

Remove a generated-app runtime member.

Remove the configured custom domain from the app and clean up the platform-side hostname registration when possible.

Rename or move one app source file atomically. Internally stages an upsert at new_path and a delete at old_path, validates the resulting app state, and creates a Saved Version before applying.

Restore one file from a Saved Version instead of restoring the entire app. Creates a Saved Version before changing the file.

Compatibility endpoint for full Saved Version restore. MCP cannot execute this operation because it can replace database records without the dedicated in-chat approval flow. Use list_saved_versions and compare_current_to_version for read-only inspection, then ask the authenticated app owner to restore through the Fine Structure UI.

Compatibility tool for proposing starter-record creation. It never inserts records directly: it creates a pending approval that the app owner must approve or reject in Studio chat. Approval-free initial seed is server-controlled inside create_app and cannot be requested through MCP.

Create or update server-side read/write role policy for an app entity.

Set which app host should be treated as primary for generated links and custom-domain redirects.

Create or update a server-owned route policy for a generated app route.

Create or update one encrypted app secret. The secret value is never returned.

Update a native A/B test, including active state, variants, traffic, and conversion goal. Creates a Saved Version before the change.

Update an existing application with a new prompt. The AI modifies the app based on your instructions. Creates a Saved Version before the update. Returns a job_id - poll get_job_status to track progress.

Update a generated-app runtime member role. This cannot assign owner and cannot change the Fine Structure account owner.

Set relationship/index metadata on an entity schema. This stores metadata in the schema file; DB index creation is automatic where supported by the platform.

Compatibility tool for proposing an update to one record by ID. It returns a pending approval and never changes the record until the app owner approves it in Studio chat.

Propose updates to exact records. Select explicit record_ids or exact-match filters and provide shared changes, or provide per-record updates. The database remains unchanged until the app owner approves the frozen request in Studio chat.

Replace or shallow-merge an existing entity schema file. Creates a Saved Version before writing.

Run deterministic app checks: syntax, imports, routes/pages, entity schemas, missing entities, and recorded runtime errors.

Validate current app files plus staged change set files before applying.

Validate entity relationship metadata and *_id references against existing entity schemas.

Create or replace one file in an app's virtual filesystem. Creates a Saved Version before changing content.