Back to search
100
MCP live v1.0.2 MCP 2025-11-25 streamable-http

Fine Structure

ai.finestructure/fine-structure

Build and host full-stack apps from a prompt, with agents that reach you on WhatsApp and email.

Uptime
100.0%
1 direct probes · 30d
Response
1050ms
last probe
Tools
84
callable
Resources
0
readable
Prompts
13
available
Primary URL
https://finestructure.ai/api/mcp

Tools · 84

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.…

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_list_clients

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

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 accept…

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_get_claim_status

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

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 progres…

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.

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, se…

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/integ…

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 complet…

get_app_status

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

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.

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.

set_app_subdomain

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 uniqueness checks as the Stu…

check_subdomain_available

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 the exact reason. Pa…

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.

get_domain_verification

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

check_domain_verification

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

set_primary_domain

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

remove_custom_domain

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

get_domain_ssl_status

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

configure_domain_redirects

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

list_apps

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.

get_app_files

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

read_app_file

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_app_files

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.

write_app_file

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 at https://finestruc…

patch_app_file

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, documented at https…

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.

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_entities

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

query_entity

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

seed_entity

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).

create_entity_records

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

update_entity_record

Compatibility tool that updates one record by ID. Executes directly for the authenticated app owner.

update_entity_records

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; expected_count abo…

delete_entity_records

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.

get_pages

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

get_errors

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

get_app_analytics

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.

get_preview_url

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

list_saved_versions

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

create_change_set

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

add_file_change

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://finestructure.ai/api/mcp/d…

validate_change_set

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

apply_change_set

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

discard_change_set

Discard a pending staged change set without changing app files.

validate_app

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

inspect_preview

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

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…

set_route_policy

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

set_entity_policy

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

list_app_members

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

invite_app_member

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 which password the …

update_app_member_role

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

remove_app_member

Remove a generated-app runtime member.

get_app_security_audit

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

compare_saved_versions

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

compare_current_to_version

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

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. Paths follow the Fine Structure app file API, documented at https://finestr…

create_entity_schema

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

update_entity_schema

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

validate_entity_relationships

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

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.

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.

delete_secret

Delete one app secret by key.

list_integrations

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

configure_integration

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

list_ab_tests

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

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.

update_ab_test

Update a native A/B test, including active state, variants, traffic, and conversion goal. 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.

create_agent

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, it can read and wr…

list_agents

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

schedule_agent_task

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:MM + timezone), week…

list_agent_tasks

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

get_agent_whatsapp

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 agent. Call this first …

start_owner_phone_verification

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 agents messaging the ow…

confirm_owner_phone_verification

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 connectable.

attach_agent_whatsapp

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_number_id from get_age…

detach_agent_whatsapp

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

Prompts · 13

build_app

Generate a complete working application: pages, database, forms and logic, then publish it.

build_website

A multi-page site for a business: home, about, services, contact, with a working contact form.

build_landing_page

One focused page built to convert: headline, proof, and a form that captures leads.

build_online_store

A product catalogue with a cart and an order flow, and an admin view of the orders.

build_internal_tool

Something for a team rather than the public: records, roles and a login wall.

build_booking_system

Appointments or reservations: availability, a booking form, and a view of what is booked.

add_whatsapp_agent

Create a standing agent, verify my phone, and connect a number so it can reach me and I can reply.

publish_and_share

Take an existing app live and return the link that actually works for other people.

improve_existing_app

Edit an app you already built: wording, design, a new page or a new field.

fix_app_errors

Read the real runtime errors from a published app and repair them.

add_login_to_app

Gate pages so only signed-in people can see them, and invite the first members.

check_app_traffic

Real traffic for a published app: visitors, pages, and where they came from.

add_data_to_app

Define what an app stores, and put real records in it.

How to use

Add to your Claude Desktop / Cursor / Cline MCP config:

{
  "mcpServers": {
    "fine_structure": {
      "url": "https://finestructure.ai/api/mcp",
      "transport": "streamable-http"
    }
  }
}