# Fine Structure MCP server

Remote MCP server for agents that create, edit, validate, and publish Fine Structure apps.

## Links
- Registry page: https://www.getdrio.com/mcp/ai-finestructure-fine-structure

## Install
- Endpoint: https://finestructure.ai/api/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://finestructure.ai/api/mcp
- Header: Authorization

## Tools
- create_app - 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. Endpoint: https://finestructure.ai/api/mcp
- agency_create_client - 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. Endpoint: https://finestructure.ai/api/mcp
- agency_list_clients - Agency mode only. List client records and app handoff status for the authenticated agent. Endpoint: https://finestructure.ai/api/mcp
- agency_create_client_app - 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. Endpoint: https://finestructure.ai/api/mcp
- agency_create_claim_link - 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. Endpoint: https://finestructure.ai/api/mcp
- agency_get_claim_status - Agency mode only. Inspect one handoff status without exposing the raw claim token. Endpoint: https://finestructure.ai/api/mcp
- update_app - 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. Endpoint: https://finestructure.ai/api/mcp
- publish_app - 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. Endpoint: https://finestructure.ai/api/mcp
- get_platform_guide - 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. Endpoint: https://finestructure.ai/api/mcp
- get_recommended_workflow - 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. Endpoint: https://finestructure.ai/api/mcp
- get_job_status - 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. Endpoint: https://finestructure.ai/api/mcp
- get_app_status - Get app overview: files, published state, URL, active jobs. Endpoint: https://finestructure.ai/api/mcp
- get_app_links - 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. Endpoint: https://finestructure.ai/api/mcp
- list_app_domains - List an app's platform path, subdomain, and configured custom domain with verification, SSL, primary-domain, redirect, publish, and login-gating status. Endpoint: https://finestructure.ai/api/mcp
- add_custom_domain - 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 their DNS provider. Endpoint: https://finestructure.ai/api/mcp
- get_domain_verification - Return the exact DNS records and instructions required to verify and route the app custom domain. Endpoint: https://finestructure.ai/api/mcp
- check_domain_verification - Check Fine Structure custom-domain verification and SSL status for the configured custom domain, then save the latest status. Endpoint: https://finestructure.ai/api/mcp
- set_primary_domain - Set which app host should be treated as primary for generated links and custom-domain redirects. Endpoint: https://finestructure.ai/api/mcp
- remove_custom_domain - Remove the configured custom domain from the app and clean up the platform-side hostname registration when possible. Endpoint: https://finestructure.ai/api/mcp
- get_domain_ssl_status - Return SSL/certificate status and pending certificate validation DNS records for the app custom domain. Endpoint: https://finestructure.ai/api/mcp
- configure_domain_redirects - Configure custom-domain redirect policy: primary domain, optional www/root redirect, and HTTPS enforcement. Endpoint: https://finestructure.ai/api/mcp
- list_apps - List all applications owned by the authenticated user. Endpoint: https://finestructure.ai/api/mcp
- get_app_files - Get the file tree for an app with paths and byte sizes. Endpoint: https://finestructure.ai/api/mcp
- read_app_file - Read one source file from an app's virtual filesystem. Endpoint: https://finestructure.ai/api/mcp
- read_app_files - Read several source files from an app's virtual filesystem. Endpoint: https://finestructure.ai/api/mcp
- write_app_file - Create or replace one file in an app's virtual filesystem. Creates a Saved Version before changing content. Endpoint: https://finestructure.ai/api/mcp
- patch_app_file - Patch one file by replacing exact text. Safer than full overwrite for targeted edits. Creates a Saved Version before changing content. Endpoint: https://finestructure.ai/api/mcp
- rename_app_file - 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. Endpoint: https://finestructure.ai/api/mcp
- get_app_detail - 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. Endpoint: https://finestructure.ai/api/mcp
- get_entities - Get all entity (data model) schemas for an app, with record counts. Each entity has fields, types, and relationships. Endpoint: https://finestructure.ai/api/mcp
- query_entity - Query app data records for one entity with optional exact-match filters. Endpoint: https://finestructure.ai/api/mcp
- seed_entity - 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. Endpoint: https://finestructure.ai/api/mcp
- create_entity_records - Propose creating/inserting records in one app entity. No records are written until the app owner explicitly approves the frozen request in Studio chat. Endpoint: https://finestructure.ai/api/mcp
- update_entity_record - 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. Endpoint: https://finestructure.ai/api/mcp
- update_entity_records - 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. Endpoint: https://finestructure.ai/api/mcp
- delete_entity_records - Propose deleting exact records by ID or exact-match filters. It freezes the matched IDs and returns a pending approval; zero records are deleted until the app owner approves in Studio chat. Endpoint: https://finestructure.ai/api/mcp
- get_pages - Get all pages in an app with their file paths and sizes. Endpoint: https://finestructure.ai/api/mcp
- get_errors - Get recent runtime errors for an app (last 20). Useful for diagnosing issues before updating. Endpoint: https://finestructure.ai/api/mcp
- get_preview_url - Return editor preview and published/public URLs for an app. Endpoint: https://finestructure.ai/api/mcp
- list_saved_versions - List restorable Saved Versions for an app, including versions created by MCP writes. Endpoint: https://finestructure.ai/api/mcp
- restore_saved_version - 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. Endpoint: https://finestructure.ai/api/mcp
- create_change_set - Create a staged file change set. Add multiple file changes, validate them as one app state, then apply atomically. Endpoint: https://finestructure.ai/api/mcp
- add_file_change - Stage one file upsert or delete inside a change set. Does not modify the live app until apply_change_set. Endpoint: https://finestructure.ai/api/mcp
- validate_change_set - Validate current app files plus staged change set files before applying. Endpoint: https://finestructure.ai/api/mcp
- apply_change_set - Apply a staged change set to the app. Creates a Saved Version before applying. Blocks on validation errors unless force=true. Endpoint: https://finestructure.ai/api/mcp
- discard_change_set - Discard a pending staged change set without changing app files. Endpoint: https://finestructure.ai/api/mcp
- validate_app - Run deterministic app checks: syntax, imports, routes/pages, entity schemas, missing entities, and recorded runtime errors. Endpoint: https://finestructure.ai/api/mcp
- inspect_preview - Return server-side preview context: URLs, persisted runtime/network errors, static clickable candidates, pages, and explicit live-browser availability. Endpoint: https://finestructure.ai/api/mcp
- get_app_security_context - 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. Endpoint: https://finestructure.ai/api/mcp
- set_route_policy - Create or update a server-owned route policy for a generated app route. Endpoint: https://finestructure.ai/api/mcp
- set_entity_policy - Create or update server-side read/write role policy for an app entity. Endpoint: https://finestructure.ai/api/mcp
- list_app_members - List generated-app runtime users/members for an app. This is separate from Studio project collaborators. Endpoint: https://finestructure.ai/api/mcp
- invite_app_member - 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. Endpoint: https://finestructure.ai/api/mcp
- update_app_member_role - Update a generated-app runtime member role. This cannot assign owner and cannot change the Fine Structure account owner. Endpoint: https://finestructure.ai/api/mcp
- remove_app_member - Remove a generated-app runtime member. Endpoint: https://finestructure.ai/api/mcp
- get_app_security_audit - Read recent server-side security audit events for an app. Endpoint: https://finestructure.ai/api/mcp
- compare_saved_versions - Compare two Saved Versions and return per-file additions, removals, modifications, and compact diffs. Endpoint: https://finestructure.ai/api/mcp
- compare_current_to_version - Compare the current app files to a Saved Version and return compact per-file diffs. Endpoint: https://finestructure.ai/api/mcp
- restore_file_from_version - Restore one file from a Saved Version instead of restoring the entire app. Creates a Saved Version before changing the file. Endpoint: https://finestructure.ai/api/mcp
- create_entity_schema - Create an entity schema file in entities/<Entity>.json. Creates a Saved Version before writing. Endpoint: https://finestructure.ai/api/mcp
- update_entity_schema - Replace or shallow-merge an existing entity schema file. Creates a Saved Version before writing. Endpoint: https://finestructure.ai/api/mcp
- validate_entity_relationships - Validate entity relationship metadata and *_id references against existing entity schemas. Endpoint: https://finestructure.ai/api/mcp
- update_entity_metadata - 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. Endpoint: https://finestructure.ai/api/mcp
- list_secret_keys - List secret key names for an app. Secret values are never returned. Endpoint: https://finestructure.ai/api/mcp
- set_secret - Create or update one encrypted app secret. The secret value is never returned. Endpoint: https://finestructure.ai/api/mcp
- delete_secret - Delete one app secret by key. Endpoint: https://finestructure.ai/api/mcp
- list_integrations - List supported integrations and safe connected integration metadata for an app. Tokens/secrets are never returned. Endpoint: https://finestructure.ai/api/mcp
- configure_integration - Store safe non-secret integration metadata for an app. Use set_secret for API keys/tokens. Endpoint: https://finestructure.ai/api/mcp
- list_ab_tests - List the platform A/B tests configured for an app. Endpoint: https://finestructure.ai/api/mcp
- create_ab_test - 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. Endpoint: https://finestructure.ai/api/mcp
- update_ab_test - Update a native A/B test, including active state, variants, traffic, and conversion goal. Creates a Saved Version before the change. Endpoint: https://finestructure.ai/api/mcp
- delete_ab_test - Delete a native A/B test from an app. Creates a Saved Version before the change. Endpoint: https://finestructure.ai/api/mcp
- get_ab_test_stats - Get views, unique visitors, conversions, and conversion rates for an A/B test. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_status - Admin only. Inspect the isolated Email Marketing module: enabled state, sender settings, templates, sequences, variable triggers, and recent campaign status. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_configure_sender - Admin only. Configure global Email Marketing sender details and module enabled state. Unsubscribe footer remains mandatory. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_update_template - Admin only. Update an automatic Email Marketing template, such as user_joined welcome email. The unsubscribe block is still appended by the server. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_create_broadcast - Admin only. Create a filtered broadcast campaign, optionally scheduled or sent now. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_create_sequence - Admin only. Create a scheduled email sequence using fixed dates or day offsets. Each generated email keeps mandatory unsubscribe. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_create_variable_trigger - 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. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_trigger_variable - Admin only. Manually fire variable-transition email rules for one user. Useful for MCP/agent workflows and tests. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_status - Inspect app-scoped Email Marketing for one generated app: settings, contacts, campaigns, event triggers, and recent events. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_configure - Configure isolated Email Marketing settings for a generated app. Can be used by Studio/chat agents. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_sync_contacts - Sync an app entity table into app-scoped Email Marketing contacts. Records without a valid email are skipped. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_create_broadcast - Create an app-scoped broadcast to contacts synced from that generated app, optionally scheduled or sent now. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_create_event_trigger - Create an app-scoped email rule that sends when an app event is recorded, for example entity_created or Customer.created. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_record_event - Record an app event and send matching app-scoped Email Marketing triggers. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_create_workflow - Create an app-scoped automation workflow with email, wait, condition, split, and goal steps. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_create_sequence - Create an app-scoped email sequence using fixed dates or day offsets between emails. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_report - Read app-scoped Email Marketing reporting: delivery counts, open/click rates, and recent tracking events. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_create_segment - Create an app-scoped saved audience segment using field, tag, and behavior filters. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_contact_profile - Read a contact profile with email delivery, tracking, app-event, workflow, suppression, and unsubscribe timeline. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_deliverability - Read provider readiness, bounce/complaint rates, suppression reasons, and recent deliverability risk events. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_process_queue - Process due app-scoped automation workflow runs and email queue jobs with locks, retries, and suppression checks. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_queue_status - Inspect app-scoped Email Marketing queue jobs and per-status counts. Endpoint: https://finestructure.ai/api/mcp
- email_marketing_app_suppress_contact - Suppress an app contact email after a bounce, complaint, manual block, provider block, or unsubscribe. Endpoint: https://finestructure.ai/api/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: ai.finestructure
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 17, 2026
- Source: https://registry.modelcontextprotocol.io