Fine Structure MCP Server

ai.finestructure/fine-structure

answering

Fine Structure is answering right now. Last checked 7 min ago. It exposes 95 tools.

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

Uptime history 41 hours of history

41 hours agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

539 ms

Response time

average over 24h

open, no key

Access

streamable-http

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 7 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add fine-structure --transport http https://finestructure.ai/api/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.fine-structure]
url = "https://finestructure.ai/api/mcp"

.cursor/mcp.json

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

.vscode/mcp.json

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

Available tools 95

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

email_marketing_app_configure

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

email_marketing_app_contact_profile

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

email_marketing_app_create_broadcast

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

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.

email_marketing_app_create_segment

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

email_marketing_app_create_sequence

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

email_marketing_app_create_workflow

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

email_marketing_app_deliverability

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

email_marketing_app_process_queue

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

email_marketing_app_queue_status

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

email_marketing_app_record_event

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

email_marketing_app_report

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

email_marketing_app_status

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

email_marketing_app_suppress_contact

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

email_marketing_app_sync_contacts

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

email_marketing_configure_sender

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

email_marketing_create_broadcast

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

email_marketing_create_sequence

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

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.

email_marketing_status

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

email_marketing_trigger_variable

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

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.

app

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.

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.

get_app_files

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

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.

get_app_security_audit

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

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.

get_app_status

Get app overview: files, published state, URL, active jobs.

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.

list_app_members

List generated-app runtime users/members for an app. This is separate from Studio project collaborators.

read_app_file

Read one source file from an app's virtual filesystem.

read_app_files

Read several source files from an app's virtual filesystem.

remove_app_member

Remove a generated-app runtime member.

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.

update_app_member_role

Update a generated-app runtime member role. This cannot assign owner and cannot change the Fine Structure account owner.

write_app_file

Create or replace one file in an app's virtual filesystem. Creates a Saved Version before changing content.

entity

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.

create_entity_schema

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

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.

query_entity

Query app data records for one entity with optional exact-match filters.

set_entity_policy

Create or update server-side read/write role policy for an app entity.

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.

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.

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.

update_entity_schema

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

agency

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.

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.

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.

agency_get_claim_status

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

agency_list_clients

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

test

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.

delete_ab_test

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

get_ab_test_stats

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

update_ab_test

Update a native A/B test, including active state, variants, traffic, and conversion goal. Creates a Saved Version before the change.

domain

check_domain_verification

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

get_domain_ssl_status

Return SSL/certificate status and pending certificate validation DNS records for the app custom domain.

get_domain_verification

Return the exact DNS records and instructions required to verify and route the app custom domain.

secret

delete_secret

Delete one app secret by key.

list_secret_keys

List secret key names for an app. Secret values are never returned.

set_secret

Create or update one encrypted app secret. The secret value is never returned.

validate

validate_app

Run deterministic app checks: syntax, imports, routes/pages, entity schemas, missing entities, and recorded runtime errors.

validate_change_set

Validate current app files plus staged change set files before applying.

validate_entity_relationships

Validate entity relationship metadata and *_id references against existing entity schemas.

compare

compare_current_to_version

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

compare_saved_versions

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

configure

configure_domain_redirects

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

configure_integration

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

custom

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.

remove_custom_domain

Remove the configured custom domain from the app and clean up the platform-side hostname registration when possible.

restore

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.

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.

apply

apply_change_set

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

apps

list_apps

List all applications owned by the authenticated user.

change

create_change_set

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

discard

discard_change_set

Discard a pending staged change set without changing app files.

entities

get_entities

Get all entity (data model) schemas for an app, with record counts. Each entity has fields, types, and relationships.

errors

get_errors

Get recent runtime errors for an app (last 20). Useful for diagnosing issues before updating.

file

add_file_change

Stage one file upsert or delete inside a change set. Does not modify the live app until apply_change_set.

inspect

inspect_preview

Return server-side preview context: URLs, persisted runtime/network errors, static clickable candidates, pages, and explicit live-browser availability.

integrations

list_integrations

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

invite

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.

job

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.

pages

get_pages

Get all pages in an app with their file paths and sizes.

patch

patch_app_file

Patch one file by replacing exact text. Safer than full overwrite for targeted edits. Creates a Saved Version before changing content.

platform

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.

preview

get_preview_url

Return editor preview and published/public URLs for an app.

primary

set_primary_domain

Set which app host should be treated as primary for generated links and custom-domain redirects.

publish

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.

recommended

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.

rename

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.

route

set_route_policy

Create or update a server-owned route policy for a generated app route.

saved

list_saved_versions

List restorable Saved Versions for an app, including versions created by MCP writes.

seed

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.

tests

list_ab_tests

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

Endpoints

URL	Transport	State	Latency	Checked
https://finestructure.ai/api/mcp	streamable-http	answering	535 ms	7 min ago

Fine Structure — questions

Answers built from our own checks of this server.

What can Fine Structure do?

It exposes 95 tools, read directly from the server on our last check. Among them: add_custom_domain, add_file_change, agency_create_claim_link, agency_create_client, agency_create_client_app, agency_get_claim_status and 89 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Fine Structure mostly used for?

Its tools cluster around email, app and entity. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Fine Structure working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 539 ms. The bar chart above shows every period we have measured.

How do I connect Fine Structure?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Fine Structure need an API key?

No. Fine Structure completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 95 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Fine Structure?

It answers our handshake in 539 ms on average, which is faster than 20% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.