Fine Structure

Agency mode only. Create or update a client record for an account-level agent. This does not create a verified Fine Structure user account and does not transfer ownership.

Agency mode only. Create a new app owned by the agent, start generation, and create a claim link for the client. Ownership transfers only when the invited client logs in with the same email and accepts the claim link.

Agency mode only. Inspect one handoff status without exposing the raw claim token.

Agency mode only. List client records and app handoff status for the authenticated agent.

Apply a staged change set to the app. Creates a Saved Version before applying. Blocks on validation errors unless force=true.

Check Fine Structure custom-domain verification and SSL status for the configured custom domain, then save the latest status.

Compare the current app files to a Saved Version and return compact per-file diffs.

Compare two Saved Versions and return per-file additions, removals, modifications, and compact diffs.

Configure custom-domain redirect policy: primary domain, optional www/root redirect, and HTTPS enforcement.

Store safe non-secret integration metadata for an app. Use set_secret for API keys/tokens.

Create a native Fine Structure A/B test between existing app pages. Use update_app first if a variant page still needs to be generated. Creates a Saved Version before the change.

Create a new application from a natural language prompt. The AI generates a complete web app with pages, components, styling, and data models. Returns a job_id - poll get_job_status to track progress. When the job is done, the app is ready.

Create a staged file change set. Add multiple file changes, validate them as one app state, then apply atomically.

Create an entity schema file in entities/<Entity>.json. Creates a Saved Version before writing.

Delete a native A/B test from an app. Creates a Saved Version before the change.

Delete one app secret by key.

Discard a pending staged change set without changing app files.

Configure isolated Email Marketing settings for a generated app. Can be used by Studio/chat agents.

Read a contact profile with email delivery, tracking, app-event, workflow, suppression, and unsubscribe timeline.

Create an app-scoped broadcast to contacts synced from that generated app, optionally scheduled or sent now.

Create an app-scoped email rule that sends when an app event is recorded, for example entity_created or Customer.created.

Create an app-scoped saved audience segment using field, tag, and behavior filters.

Create an app-scoped email sequence using fixed dates or day offsets between emails.

Create an app-scoped automation workflow with email, wait, condition, split, and goal steps.

Read provider readiness, bounce/complaint rates, suppression reasons, and recent deliverability risk events.

Process due app-scoped automation workflow runs and email queue jobs with locks, retries, and suppression checks.

Inspect app-scoped Email Marketing queue jobs and per-status counts.

Record an app event and send matching app-scoped Email Marketing triggers.

Read app-scoped Email Marketing reporting: delivery counts, open/click rates, and recent tracking events.

Inspect app-scoped Email Marketing for one generated app: settings, contacts, campaigns, event triggers, and recent events.

Suppress an app contact email after a bounce, complaint, manual block, provider block, or unsubscribe.

Sync an app entity table into app-scoped Email Marketing contacts. Records without a valid email are skipped.

Admin only. Configure global Email Marketing sender details and module enabled state. Unsubscribe footer remains mandatory.

Admin only. Create a filtered broadcast campaign, optionally scheduled or sent now.

Admin only. Create a scheduled email sequence using fixed dates or day offsets. Each generated email keeps mandatory unsubscribe.

Admin only. Create an email rule that sends when a named variable changes from one value to another. Empty from_value/to_value acts as wildcard.

Admin only. Inspect the isolated Email Marketing module: enabled state, sender settings, templates, sequences, variable triggers, and recent campaign status.

Admin only. Manually fire variable-transition email rules for one user. Useful for MCP/agent workflows and tests.

Admin only. Update an automatic Email Marketing template, such as user_joined welcome email. The unsubscribe block is still appended by the server.

Get views, unique visitors, conversions, and conversion rates for an A/B test.

Deep introspection of an app: entities, pages, settings, integrations, environment variables, and file structure. Use this to understand what an app contains before updating it.

Get the file tree for an app with paths and byte sizes.

Return editor, preview, published path, subdomain, and custom-domain links plus whether each works for anonymous visitors, app users, or Studio users based on publish and auth settings.

Read recent server-side security audit events for an app.

Return safe security context for one owned app: owner id/email, Studio collaborators, generated-app members, route policies, entity policies, and recent security audit entries. Does not return secrets and does not grant access to other apps.

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.

Restore an app to a Saved Version. Requires versions:write scope and confirm=true. This restores files, records, app settings, and A/B test state captured in the snapshot.

Seed records into one app entity. Useful during EDIT when new screens need sample data. Creates a Saved Version before inserting records.

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.

Update one app entity record by ID. Creates a Saved Version before the update.

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.