servers / fine-structure

Fine Structure MCP server

communitystreamable_httpremotedestructive capablehealthy

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


01Tools · 92

How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.

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

02Install & source
https://finestructure.ai/api/mcp
remote_url

03Access granted
Schedule a meeting · write

The access this server can exercise, inferred from its verified tools — not a declared OAuth scope.


05Provenance & freshness
sourcesOfficial MCP Registry [p1]
last_checked2026-07-17 22:20Z
next_check2026-07-19 22:19Z
cadenceevery 48h
verifiedtools_list:passed handshake:passed metadata:passed
index_statusindex5 unique facts >= 5

06Badge

Add the “as seen on MCPExplorer” badge to your README. Fine Structure MCP — as seen on mcpexplorer.com

[![Fine Structure MCP — as seen on mcpexplorer.com](https://mcpexplorer.com/badge/fine-structure.svg)](https://mcpexplorer.com/servers/fine-structure)

Next step

This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.

Explore loadouts →
Fine Structure MCP server — MCPExplorer