Fine Structure

可用工具

• create_appCreate 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.
• agency_create_clientAgency 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_list_clientsAgency mode only. List client records and app handoff status for the authenticated agent.
• agency_create_client_appAgency 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_create_claim_linkAgency 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_get_claim_statusAgency mode only. Inspect one handoff status without exposing the raw claim token.
• update_appUpdate 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.
• publish_appPublish 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.
• get_platform_guideReturn 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.
• get_recommended_workflowReturn 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.
• get_job_statusPoll 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_app_statusGet app overview: files, published state, URL, active jobs.
• get_app_linksReturn 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.
• list_app_domainsList an app's platform path, subdomain, and configured custom domain with verification, SSL, primary-domain, redirect, publish, and login-gating status.
• set_app_subdomainSet 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 uniqueness checks as the Studio subdomain field because it calls the same model function. Replacing a subdomain takes effect immediately and creates NO redirect: the previous name stops resolving to this app and is released for anyone to claim. Pass an empty subdomain to clear it. For a domain the user owns, use add_custom_domain instead.
• check_subdomain_availableCheck 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 the exact reason. Pass app_id (an app you own) to have that app's own current subdomain reported as 'current' instead of 'taken'.
• add_custom_domainAttach 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 their DNS provider.
• get_domain_verificationReturn the exact DNS records and instructions required to verify and route the app custom domain.
• check_domain_verificationCheck Fine Structure custom-domain verification and SSL status for the configured custom domain, then save the latest status.
• set_primary_domainSet which app host should be treated as primary for generated links and custom-domain redirects.
• remove_custom_domainRemove the configured custom domain from the app and clean up the platform-side hostname registration when possible.
• get_domain_ssl_statusReturn SSL/certificate status and pending certificate validation DNS records for the app custom domain.
• configure_domain_redirectsConfigure custom-domain redirect policy: primary domain, optional www/root redirect, and HTTPS enforcement.
• list_appsList owned and accepted Studio-shared applications, newest activity first. Returns up to `limit` apps per call plus the total count; page with `offset` when the account has more. Accepted editors can edit shared source; viewers can read it. Publishing, records, domains and security administration remain owner-only.
• get_app_filesGet the file tree for an app with paths and byte sizes.
• read_app_fileRead 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_app_filesRead 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.
• write_app_fileCreate 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 at https://finestructure.ai/api/mcp/docs.
• patch_app_filePatch 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, documented at https://finestructure.ai/api/mcp/docs.
• rename_app_fileRename 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.
• get_app_detailDeep 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_entitiesGet all entity (data model) schemas for an app, with record counts. Each entity has fields, types, and relationships.
• query_entityQuery app data records for one entity with optional exact-match filters.
• seed_entityCompatibility tool for starter-record creation. Inserts directly for the authenticated app owner; by default it only seeds an empty entity (skip_if_not_empty).
• create_entity_recordsCreate/insert records in one app entity. Executes directly for the authenticated app owner and returns the created record ids.
• update_entity_recordCompatibility tool that updates one record by ID. Executes directly for the authenticated app owner.
• update_entity_recordsUpdate 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; expected_count aborts the write on a mismatch.
• delete_entity_recordsDelete 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.
• get_pagesGet all pages in an app with their file paths and sizes.
• get_errorsGet recent runtime errors for an app (last 20). Useful for diagnosing issues before updating.
• get_app_analyticsTraffic 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.
• get_preview_urlReturn editor preview and published/public URLs for an app.
• list_saved_versionsList restorable Saved Versions for an app, including versions created by MCP writes.
• create_change_setCreate a staged file change set. Add multiple file changes, validate them as one app state, then apply atomically.
• add_file_changeStage 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://finestructure.ai/api/mcp/docs.
• validate_change_setValidate current app files plus staged change set files before applying.
• apply_change_setApply a staged change set to the app. Creates a Saved Version before applying. Blocks on validation errors unless force=true.
• discard_change_setDiscard a pending staged change set without changing app files.
• validate_appRun deterministic app checks: syntax, imports, routes/pages, entity schemas, missing entities, and recorded runtime errors.
• inspect_previewReturn server-side preview context: URLs, persisted runtime/network errors, static clickable candidates, pages, and explicit live-browser availability.
• get_app_security_contextReturn safe security context for one owned app: owner id/email, Studio collaborators, generated-app members, route policies, entity policies, function policies, and recent security audit entries. Does not return secrets and does not grant access to other apps.
• set_route_policyCreate or update a server-owned route policy for a generated app route.
• set_function_policyCreate 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 visitors and webhooks). Recipes: anonymous checkout step or inbound webhook/IPN -> require_auth=false; signed-in members -> require_auth=true + allowed_roles (e.g. ['authenticated'] or ['admin','staff']); webhook with a shared secret -> require_secret=true + secret_name (an app secret) that the caller sends in secret_header. allowed_hosts fences the function's outbound network to those hosts plus the platform backend; omit it for open egress.
• invoke_functionRun 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 function policy as a public visitor and returns the 401/403 decision without running when access would be denied. Use it to verify a function (secrets, outbound calls, policy) before wiring it into the app.
• create_platform_requestOpen 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 platform blocks you instead of working around it. Give a reproduction the team can run (invoke_function / curl / the exact tool call and result), what you expected, and how the team will know it is closed. Credential-looking values are redacted. Returns request_id and a Studio URL; the team's replies, status changes and deployments come back through get_platform_request / list_platform_requests. Limits: 20 per account per day, 32 KB.
• get_platform_requestOne 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). Pass since=<ISO timestamp> to get only the events after it.
• list_platform_requestsYour 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 questions to answer, deployments with their commit. Filters: app_id, status.
• reply_platform_requestAdd 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).
• update_platform_requestPlatform 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 mail the requester.
• set_entity_policyReplace 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 replaces any existing action rules with read/write role behavior.

更新日期：2026-10-29（tools/list 实测）

配置到 Claude / Cursor

{
  "mcpServers": {
    "remote-ai-finestructure-fine-structure": {
      "type": "http",
      "url": "https://finestructure.ai/api/mcp"
    }
  }
}