MCP serverai.finestructure/fine-structure

Attach or replace the app custom domain through the same Fine Structure Studio custom-domain flow. Returns exact DNS verification and routing records for the user to configure at t

Stage one file upsert or delete inside a change set. Does not modify the live app until apply_change_set. Paths follow the Fine Structure app file API, documented at https://finest

Agency mode only. Create a client claim link for an existing app owned by the agent. The client must log in with the invited email before ownership transfers.

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 s

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.

Connect a platform WhatsApp number to one of the account's agents, so the owner can message that number and reach that agent. Requires the owner to be verified first. Take phone_nu

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

Check whether a platform subdomain can be claimed before calling set_app_subdomain. Returns available plus a status of available, invalid, reserved, taken, current, or empty, with

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.

Confirm the 6-digit code the owner received on WhatsApp from start_owner_phone_verification. On success the owner is verified: agents can message them, and platform numbers become

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 an autonomous AI agent on the user's Fine Structure account: a standing worker, not a chat session. It gets the platform's default safe tool policy and its own email address

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_statu

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

Create/insert records in one app entity. Executes directly for the authenticated app owner and returns the created record ids.

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

Open a request to the Fine Structure platform team: a bug, a feature request or a question about the platform itself (not about the user's app). Use it when something in the platfo

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

Delete exact records by ID or exact-match filters. Executes directly for the authenticated app owner; pass expected_count as a safety check to abort on a mismatch.

Delete one app secret by key.

Disconnect the owner's WhatsApp route from a platform number. Removes only this account's route; other accounts sharing the number keep theirs.

Discard a pending staged change set without changing app files.

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

Read the WhatsApp state of the connected account: whether the owner's phone is verified, which platform numbers they can connect, and which conversations already route to which age

Traffic analytics for an app's published site over a chosen window: total views, unique visitors, daily series, top pages, top referrer domains and device split.

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 sett

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, function policies, and recent security

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

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, publish

One platform request with its full history: team replies, status changes (open | triaged | in_progress | needs_info | deployed | wont_fix) and what was deployed (commit, time). Pas

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 confi

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, and the owner role cannot be assigned. password is required: ask the account owner

Run a backend function of an owned app exactly like the HTTP route and return its status and JSON. caller='owner' runs as the app owner; caller='anonymous' first evaluates the func

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

List scheduled tasks for one agent (or the whole account), including schedule, status and next_run_at.

List the AI agents on the user's account with id, name, role, status and FineMail address.

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 applications owned by the authenticated user, newest activity first. Returns up to `limit` apps per call plus the total count; page with `offset` when the account has more.

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

Your account's platform requests, newest activity first. Call it at the start of a session with since=<the updated_date you last saw> to learn what changed: replies, needs_info que

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. Paths follow the Fine Structure app file API,

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. Paths follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.

Read several source files from an app's virtual filesystem. Paths follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.

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 befo

Add a reply or a finding to one of your platform requests without opening a new one, e.g. to answer a needs_info question (that reopens it).

Restore one file from a Saved Version instead of restoring the entire app. Creates a Saved Version before changing the file. Paths follow the Fine Structure app file API, documente

Create a scheduled task for one of the user's agents. Supported schedule types: once (run_at ISO local time + timezone), interval (interval_minutes 5-1440), hourly, daily (time HH:

Compatibility tool for starter-record creation. Inserts directly for the authenticated app owner; by default it only seeds an empty entity (skip_if_not_empty).

Set or clear the app platform subdomain - the '<subdomain>.<base domain>' host Fine Structure already serves the app on. Runs the same ownership, format, reserved-name and uniquene

Replace server-side entity access policy. Optional action rules override read/write roles and can allow public create without public read, update, or delete. Omitting rules replace

Create or update the server-owned access policy of a backend function (functions/<name>.js). Without a policy a function answers only to the app owner's Studio token (401 for app v

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.

Send a 6-digit code over WhatsApp to the ACCOUNT OWNER's own phone. This is the one-time ownership proof required before a platform number can be connected, and it also unlocks age

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_sta

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 that updates one record by ID. Executes directly for the authenticated app owner.

Update exact records. Select explicit record_ids or exact-match filters and provide shared changes, or provide per-record updates. Executes directly for the authenticated app owner

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

Platform team only: set the status of a request (open | triaged | in_progress | needs_info | deployed | wont_fix), attach the deployed commit and/or reply. deployed and needs_info

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. Paths and file model follow the Fine Structure app file API, documented