Fine Structure

Official92 tools

by finestructure

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

ai.finestructure/fine-structure (Remote MCP Server)

Remote MCP server for agents that create, edit, validate, and publish Fine Structure apps. It’s identified by the slug ai-finestructure-fine-structure. The server is designed to provide MCP-accessible functionality specifically around Fine Structure application lifecycle tasks.

🛠️ Key Features

Create Fine Structure apps
Edit Fine Structure apps
Validate Fine Structure apps
Publish Fine Structure apps

🚀 Use Cases

Agent-driven creation of Fine Structure applications
Automated updates and editing of Fine Structure apps
Pre-publication validation for Fine Structure apps
Controlled publishing of Fine Structure apps via an MCP-enabled workflow

⚡ Developer Benefits

Centralized MCP endpoint for Fine Structure app lifecycle operations
Clear mapping to create/edit/validate/publish actions for agents

⚠️ Limitations

No additional capabilities, tool count, or supported methods are provided in the available source data.

Captured live from the server via tools/list.

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.

Parameters3

name	string	required	Name for the app (1-100 chars)
prompt	string	required	Detailed description of the app to build
description	string	optional	Optional short description

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name for the app (1-100 chars)"
    },
    "prompt": {
      "type": "string",
      "description": "Detailed description of the app to build"
    },
    "description": {
      "type": "string",
      "description": "Optional short description",
      "default": ""
    }
  },
  "required": [
    "name",
    "prompt"
  ]
}

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.

Parameters3

client_email	string	required	Client email that will be allowed to claim projects
client_full_name	string	optional	Optional client display name
note	string	optional	Optional internal note for the agency

Raw schema

{
  "type": "object",
  "properties": {
    "client_email": {
      "type": "string",
      "description": "Client email that will be allowed to claim projects"
    },
    "client_full_name": {
      "type": "string",
      "description": "Optional client display name",
      "default": ""
    },
    "note": {
      "type": "string",
      "description": "Optional internal note for the agency",
      "default": ""
    }
  },
  "required": [
    "client_email"
  ]
}

agency_list_clients

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

Parameters1

include_handoffs

boolean

optional

Include claim links status without raw tokens

Raw schema

{
  "type": "object",
  "properties": {
    "include_handoffs": {
      "type": "boolean",
      "description": "Include claim links status without raw tokens",
      "default": true
    }
  }
}

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.

Parameters8

client_email	string	required	Client email allowed to claim ownership
client_full_name	string	optional	Optional client display name
name	string	required	Name for the app (1-100 chars)
prompt	string	required	Detailed description of the app to build
description	string	optional	Optional short app description
note	string	optional	Optional internal client/project note
keep_agent_collaborator	boolean	optional	After claim, invite the agent back as an editor collaborator
claim_expires_in_days	integer	optional	Claim link lifetime, 1-90 days

Raw schema

{
  "type": "object",
  "properties": {
    "client_email": {
      "type": "string",
      "description": "Client email allowed to claim ownership"
    },
    "client_full_name": {
      "type": "string",
      "description": "Optional client display name",
      "default": ""
    },
    "name": {
      "type": "string",
      "description": "Name for the app (1-100 chars)"
    },
    "prompt": {
      "type": "string",
      "description": "Detailed description of the app to build"
    },
    "description": {
      "type": "string",
      "description": "Optional short app description",
      "default": ""
    },
    "note": {
      "type": "string",
      "description": "Optional internal client/project note",
      "default": ""
    },
    "keep_agent_collaborator": {
      "type": "boolean",
      "description": "After claim, invite the agent back as an editor collaborator",
      "default": true
    },
    "claim_expires_in_days": {
      "type": "integer",
      "description": "Claim link lifetime, 1-90 days",
      "default": 14
    }
  },
  "required": [
    "client_email",
    "name",
    "prompt"
  ]
}

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.

Parameters6

app_id	string	required	Existing app ID owned by the agent
client_email	string	required	Client email allowed to claim ownership
client_full_name	string	optional	Optional client display name
note	string	optional	Optional internal note
keep_agent_collaborator	boolean	optional	Invite agent as editor after claim
claim_expires_in_days	integer	optional	Claim link lifetime, 1-90 days

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "Existing app ID owned by the agent"
    },
    "client_email": {
      "type": "string",
      "description": "Client email allowed to claim ownership"
    },
    "client_full_name": {
      "type": "string",
      "description": "Optional client display name",
      "default": ""
    },
    "note": {
      "type": "string",
      "description": "Optional internal note",
      "default": ""
    },
    "keep_agent_collaborator": {
      "type": "boolean",
      "description": "Invite agent as editor after claim",
      "default": true
    },
    "claim_expires_in_days": {
      "type": "integer",
      "description": "Claim link lifetime, 1-90 days",
      "default": 14
    }
  },
  "required": [
    "app_id",
    "client_email"
  ]
}

agency_get_claim_status

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

Parameters1

handoff_id

string

required

Handoff ID returned by agency_create_claim_link or agency_create_client_app

Raw schema

{
  "type": "object",
  "properties": {
    "handoff_id": {
      "type": "string",
      "description": "Handoff ID returned by agency_create_claim_link or agency_create_client_app"
    }
  },
  "required": [
    "handoff_id"
  ]
}

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.

Parameters2

app_id	string	required	The app ID to update
prompt	string	required	What to change in the app

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID to update"
    },
    "prompt": {
      "type": "string",
      "description": "What to change in the app"
    }
  },
  "required": [
    "app_id",
    "prompt"
  ]
}

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.

Parameters4

app_id	string	required	The app ID to publish
access_mode	string	optional	Live access policy. public_open = anyone can view. public_auth = public URL opens but app login is required. private = published snapshot remains owner/collaborator-only. keep = preserve current visibility/auth settings. infer = choose from existing settings and obvious app structure.
auth_required	boolean	optional	Optional explicit override for generated-app login requirement. Prefer access_mode when possible.
make_public	boolean	optional	Optional explicit override for whether published URLs are publicly reachable. Prefer access_mode when possible.

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID to publish"
    },
    "access_mode": {
      "type": "string",
      "enum": [
        "infer",
        "public_open",
        "public_auth",
        "private",
        "keep"
      ],
      "default": "infer",
      "description": "Live access policy. public_open = anyone can view. public_auth = public URL opens but app login is required. private = published snapshot remains owner/collaborator-only. keep = preserve current visibility/auth settings. infer = choose from existing settings and obvious app structure."
    },
    "auth_required": {
      "type": "boolean",
      "description": "Optional explicit override for generated-app login requirement. Prefer access_mode when possible."
    },
    "make_public": {
      "type": "boolean",
      "description": "Optional explicit override for whether published URLs are publicly reachable. Prefer access_mode when possible."
    }
  },
  "required": [
    "app_id"
  ]
}

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.

Parameters3

app_id	string	optional	Optional app ID. If provided, the guide includes a safe app context summary.
sections	array	optional	Optional subset of guide sections to return.
task_type	string	optional	Optional task hint, for example edit_app, direct_file_edit, seed_data, or publish_app.

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "Optional app ID. If provided, the guide includes a safe app context summary."
    },
    "sections": {
      "type": "array",
      "description": "Optional subset of guide sections to return.",
      "items": {
        "type": "string",
        "enum": [
          "ab_testing",
          "agency",
          "app_code",
          "checklists",
          "data_model",
          "direct_file_edit",
          "domains",
          "file_model",
          "generation",
          "overview",
          "publishing",
          "saas",
          "safety",
          "sdk",
          "secrets_integrations",
          "security",
          "validation"
        ]
      }
    },
    "task_type": {
      "type": "string",
      "description": "Optional task hint, for example edit_app, direct_file_edit, seed_data, or publish_app."
    }
  }
}

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.

Parameters3

task_type	string	optional	The task type to plan.
goal	string	optional	Optional short description of the user's goal.
app_id	string	optional	Optional app ID. If provided, the workflow includes a safe app context summary.

Raw schema

{
  "type": "object",
  "properties": {
    "task_type": {
      "type": "string",
      "description": "The task type to plan.",
      "enum": [
        "ab_test",
        "agency_client_app",
        "create_app",
        "direct_file_edit",
        "domain_setup",
        "edit_app",
        "fix_runtime_error",
        "inspect_preview",
        "publish_app",
        "saas_setup",
        "schema_change",
        "secrets_integration",
        "security_setup",
        "seed_data",
        "unknown",
        "version_restore"
      ],
      "default": "unknown"
    },
    "goal": {
      "type": "string",
      "description": "Optional short description of the user's goal.",
      "default": ""
    },
    "app_id": {
      "type": "string",
      "description": "Optional app ID. If provided, the workflow includes a safe app context summary."
    }
  }
}

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.

Parameters1

job_id

string

required

The job_id returned by create_app or update_app

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job_id returned by create_app or update_app"
    }
  },
  "required": [
    "job_id"
  ]
}

get_app_status

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

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

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.

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

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.

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

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.

Parameters2

app_id	string	required	The app ID
domain	string	required	Custom domain to connect, for example example.com or app.example.com

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "domain": {
      "type": "string",
      "description": "Custom domain to connect, for example example.com or app.example.com"
    }
  },
  "required": [
    "app_id",
    "domain"
  ]
}

get_domain_verification

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

Parameters2

app_id	string	required	The app ID
domain	string	optional	Optional configured custom domain. If omitted, uses the app's current custom domain.

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "domain": {
      "type": "string",
      "description": "Optional configured custom domain. If omitted, uses the app's current custom domain."
    }
  },
  "required": [
    "app_id"
  ]
}

check_domain_verification

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

Parameters2

app_id	string	required	The app ID
domain	string	optional	Optional configured custom domain. If omitted, uses the app's current custom domain.

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "domain": {
      "type": "string",
      "description": "Optional configured custom domain. If omitted, uses the app's current custom domain."
    }
  },
  "required": [
    "app_id"
  ]
}

set_primary_domain

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

Parameters2

app_id	string	required	The app ID
domain	string	required	Primary host, for example example.com, www.example.com, or the app subdomain host.

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "domain": {
      "type": "string",
      "description": "Primary host, for example example.com, www.example.com, or the app subdomain host."
    }
  },
  "required": [
    "app_id",
    "domain"
  ]
}

remove_custom_domain

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

Parameters2

app_id	string	required	The app ID
domain	string	optional	Optional configured custom domain. If omitted, removes the current custom domain.

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "domain": {
      "type": "string",
      "description": "Optional configured custom domain. If omitted, removes the current custom domain."
    }
  },
  "required": [
    "app_id"
  ]
}

get_domain_ssl_status

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

Parameters2

app_id	string	required	The app ID
domain	string	optional	Optional configured custom domain. If omitted, uses the app's current custom domain.

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "domain": {
      "type": "string",
      "description": "Optional configured custom domain. If omitted, uses the app's current custom domain."
    }
  },
  "required": [
    "app_id"
  ]
}

configure_domain_redirects

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

Parameters4

app_id	string	required	The app ID
primary_domain	string	required	Canonical primary domain, for example example.com
redirect_www	boolean	optional	Redirect the www/root counterpart to primary_domain
force_https	boolean	optional	Redirect HTTP custom-domain requests to HTTPS

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "primary_domain": {
      "type": "string",
      "description": "Canonical primary domain, for example example.com"
    },
    "redirect_www": {
      "type": "boolean",
      "description": "Redirect the www/root counterpart to primary_domain",
      "default": true
    },
    "force_https": {
      "type": "boolean",
      "description": "Redirect HTTP custom-domain requests to HTTPS",
      "default": true
    }
  },
  "required": [
    "app_id",
    "primary_domain"
  ]
}

list_apps

List all applications owned by the authenticated user.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_app_files

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

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

read_app_file

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

Parameters3

app_id	string	required	The app ID
path	string	required	Virtual file path, for example pages/Home.jsx
max_chars	integer	optional	Maximum content characters to return

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "path": {
      "type": "string",
      "description": "Virtual file path, for example pages/Home.jsx"
    },
    "max_chars": {
      "type": "integer",
      "description": "Maximum content characters to return",
      "default": 200000
    }
  },
  "required": [
    "app_id",
    "path"
  ]
}

read_app_files

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

Parameters3

app_id	string	required	The app ID
paths	array	required	Virtual file paths to read
max_chars_per_file	integer	optional	Maximum characters per file

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "paths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Virtual file paths to read"
    },
    "max_chars_per_file": {
      "type": "integer",
      "description": "Maximum characters per file",
      "default": 100000
    }
  },
  "required": [
    "app_id",
    "paths"
  ]
}

write_app_file

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

Parameters4

app_id	string	required	The app ID
path	string	required	Virtual file path
content	string	required	Complete file contents
file_type	string	optional	Optional file type override

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "path": {
      "type": "string",
      "description": "Virtual file path"
    },
    "content": {
      "type": "string",
      "description": "Complete file contents"
    },
    "file_type": {
      "type": "string",
      "description": "Optional file type override"
    }
  },
  "required": [
    "app_id",
    "path",
    "content"
  ]
}

patch_app_file

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

Parameters5

app_id	string	required	The app ID
path	string	required	Virtual file path
old_text	string	required	Exact existing text to replace
new_text	string	required	Replacement text
replace_all	boolean	optional	Replace all matches instead of the first match

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "path": {
      "type": "string",
      "description": "Virtual file path"
    },
    "old_text": {
      "type": "string",
      "description": "Exact existing text to replace"
    },
    "new_text": {
      "type": "string",
      "description": "Replacement text"
    },
    "replace_all": {
      "type": "boolean",
      "description": "Replace all matches instead of the first match",
      "default": false
    }
  },
  "required": [
    "app_id",
    "path",
    "old_text",
    "new_text"
  ]
}

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.

Parameters5

app_id	string	required	The app ID
old_path	string	required	Existing virtual file path to rename
new_path	string	required	New virtual file path
overwrite	boolean	optional	Allow replacing an existing file at new_path
force	boolean	optional	Apply even if validation reports blocking errors

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "old_path": {
      "type": "string",
      "description": "Existing virtual file path to rename"
    },
    "new_path": {
      "type": "string",
      "description": "New virtual file path"
    },
    "overwrite": {
      "type": "boolean",
      "description": "Allow replacing an existing file at new_path",
      "default": false
    },
    "force": {
      "type": "boolean",
      "description": "Apply even if validation reports blocking errors",
      "default": false
    }
  },
  "required": [
    "app_id",
    "old_path",
    "new_path"
  ]
}

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.

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

get_entities

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

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

query_entity

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

Parameters6

app_id	string	required	The app ID
entity	string	required	Entity name, for example Patient
filters	object	optional	Exact-match field filters
sort	string	optional	Sort field, prefix with - for descending
limit	integer	optional	Max records to return
offset	integer	optional	Pagination offset

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "entity": {
      "type": "string",
      "description": "Entity name, for example Patient"
    },
    "filters": {
      "type": "object",
      "description": "Exact-match field filters",
      "default": {}
    },
    "sort": {
      "type": "string",
      "description": "Sort field, prefix with - for descending",
      "default": "-created_date"
    },
    "limit": {
      "type": "integer",
      "description": "Max records to return",
      "default": 100
    },
    "offset": {
      "type": "integer",
      "description": "Pagination offset",
      "default": 0
    }
  },
  "required": [
    "app_id",
    "entity"
  ]
}

seed_entity

Seed records into one app entity. Useful during EDIT when new screens need sample data. Creates a Saved Version before inserting records.

Parameters4

app_id	string	required	The app ID
entity	string	required	Entity name
records	array	required	Records to insert
mode	string	optional	append always inserts; skip_if_not_empty inserts only into an empty entity

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "entity": {
      "type": "string",
      "description": "Entity name"
    },
    "records": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Records to insert"
    },
    "mode": {
      "type": "string",
      "enum": [
        "append",
        "skip_if_not_empty"
      ],
      "description": "append always inserts; skip_if_not_empty inserts only into an empty entity",
      "default": "skip_if_not_empty"
    }
  },
  "required": [
    "app_id",
    "entity",
    "records"
  ]
}

update_entity_record

Update one app entity record by ID. Creates a Saved Version before the update.

Parameters4

app_id	string	required	The app ID
entity	string	required	Entity name
record_id	string	required	Record ID
data	object	required	Fields to merge into the record

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "entity": {
      "type": "string",
      "description": "Entity name"
    },
    "record_id": {
      "type": "string",
      "description": "Record ID"
    },
    "data": {
      "type": "object",
      "description": "Fields to merge into the record"
    }
  },
  "required": [
    "app_id",
    "entity",
    "record_id",
    "data"
  ]
}

get_pages

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

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

get_errors

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

Parameters2

app_id	string	required	The app ID
limit	integer	optional	Max errors to return (default 20)

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "limit": {
      "type": "integer",
      "description": "Max errors to return (default 20)",
      "default": 20
    }
  },
  "required": [
    "app_id"
  ]
}

get_preview_url

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

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

list_saved_versions

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

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

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.

Parameters3

app_id	string	required	The app ID
snapshot_id	string	required	Saved Version snapshot_id to restore
confirm	boolean	required	Must be true to execute the restore

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "snapshot_id": {
      "type": "string",
      "description": "Saved Version snapshot_id to restore"
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true to execute the restore",
      "default": false
    }
  },
  "required": [
    "app_id",
    "snapshot_id",
    "confirm"
  ]
}

create_change_set

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

Parameters2

app_id	string	required	The app ID
label	string	optional	Optional short label

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "label": {
      "type": "string",
      "description": "Optional short label"
    }
  },
  "required": [
    "app_id"
  ]
}

add_file_change

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

Parameters6

app_id	string	required	The app ID
change_set_id	string	required	Change set ID
path	string	required	Virtual file path
content	string	optional	Complete file contents for upsert
file_type	string	optional	Optional file type override
operation	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "change_set_id": {
      "type": "string",
      "description": "Change set ID"
    },
    "path": {
      "type": "string",
      "description": "Virtual file path"
    },
    "content": {
      "type": "string",
      "description": "Complete file contents for upsert",
      "default": ""
    },
    "file_type": {
      "type": "string",
      "description": "Optional file type override",
      "default": ""
    },
    "operation": {
      "type": "string",
      "enum": [
        "upsert",
        "delete"
      ],
      "default": "upsert"
    }
  },
  "required": [
    "app_id",
    "change_set_id",
    "path"
  ]
}

validate_change_set

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

Parameters3

app_id	string	required	The app ID
change_set_id	string	required	Change set ID
include_runtime_errors	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "change_set_id": {
      "type": "string",
      "description": "Change set ID"
    },
    "include_runtime_errors": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "app_id",
    "change_set_id"
  ]
}

apply_change_set

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

Parameters3

app_id	string	required	The app ID
change_set_id	string	required	Change set ID
force	boolean	optional	Apply even if validation has errors

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "change_set_id": {
      "type": "string",
      "description": "Change set ID"
    },
    "force": {
      "type": "boolean",
      "description": "Apply even if validation has errors",
      "default": false
    }
  },
  "required": [
    "app_id",
    "change_set_id"
  ]
}

discard_change_set

Discard a pending staged change set without changing app files.

Parameters2

app_id	string	required	The app ID
change_set_id	string	required	Change set ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "change_set_id": {
      "type": "string",
      "description": "Change set ID"
    }
  },
  "required": [
    "app_id",
    "change_set_id"
  ]
}

validate_app

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

Parameters2

app_id	string	required	The app ID
include_runtime_errors	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "include_runtime_errors": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "app_id"
  ]
}

inspect_preview

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

Parameters4

app_id	string	required	The app ID
route	string	optional	Optional route to inspect
auth_as	string	optional	Optional auth simulation: anonymous
auth_as_role	string	optional	Optional app role simulation, e.g. staff/admin/customer

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "route": {
      "type": "string",
      "description": "Optional route to inspect",
      "default": ""
    },
    "auth_as": {
      "type": "string",
      "description": "Optional auth simulation: anonymous",
      "default": ""
    },
    "auth_as_role": {
      "type": "string",
      "description": "Optional app role simulation, e.g. staff/admin/customer",
      "default": ""
    }
  },
  "required": [
    "app_id"
  ]
}

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.

Parameters2

app_id	string	required	The app ID
audit_limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "audit_limit": {
      "type": "integer",
      "default": 50
    }
  },
  "required": [
    "app_id"
  ]
}

set_route_policy

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

Parameters5

app_id	string	required	The app ID
route	string	required	Route or wildcard route, e.g. /admin/*
require_auth	boolean	required
allowed_roles	array	required	Allowed app roles
redirect_to	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "route": {
      "type": "string",
      "description": "Route or wildcard route, e.g. /admin/*"
    },
    "require_auth": {
      "type": "boolean",
      "default": true
    },
    "allowed_roles": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Allowed app roles"
    },
    "redirect_to": {
      "type": "string",
      "default": "/Login"
    }
  },
  "required": [
    "app_id",
    "route",
    "require_auth",
    "allowed_roles"
  ]
}

set_entity_policy

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

Parameters4

app_id	string	required	The app ID
entity	string	required	Entity name, e.g. Booking
read	array	required	Roles allowed to read
write	array	required	Roles allowed to write

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "entity": {
      "type": "string",
      "description": "Entity name, e.g. Booking"
    },
    "read": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Roles allowed to read"
    },
    "write": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Roles allowed to write"
    }
  },
  "required": [
    "app_id",
    "entity",
    "read",
    "write"
  ]
}

list_app_members

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

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

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.

Parameters5

app_id	string	required	The app ID
email	string	required	Member email
role	string	required	App role, e.g. admin/staff/customer
full_name	string	optional
password	string	optional	Optional initial password. If omitted, one is generated.

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "email": {
      "type": "string",
      "description": "Member email"
    },
    "role": {
      "type": "string",
      "description": "App role, e.g. admin/staff/customer"
    },
    "full_name": {
      "type": "string",
      "default": ""
    },
    "password": {
      "type": "string",
      "description": "Optional initial password. If omitted, one is generated."
    }
  },
  "required": [
    "app_id",
    "email",
    "role"
  ]
}

update_app_member_role

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

Parameters3

app_id	string	required	The app ID
user_id	string	required	Generated app user id
role	string	required	New role

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "user_id": {
      "type": "string",
      "description": "Generated app user id"
    },
    "role": {
      "type": "string",
      "description": "New role"
    }
  },
  "required": [
    "app_id",
    "user_id",
    "role"
  ]
}

remove_app_member

Remove a generated-app runtime member.

Parameters2

app_id	string	required	The app ID
user_id	string	required	Generated app user id

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "user_id": {
      "type": "string",
      "description": "Generated app user id"
    }
  },
  "required": [
    "app_id",
    "user_id"
  ]
}

get_app_security_audit

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

Parameters2

app_id	string	required	The app ID
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "limit": {
      "type": "integer",
      "default": 100
    }
  },
  "required": [
    "app_id"
  ]
}

compare_saved_versions

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

Parameters4

app_id	string	required	The app ID
base_snapshot_id	string	required	Older/base snapshot ID
target_snapshot_id	string	required	Newer/target snapshot ID
max_diff_chars	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "base_snapshot_id": {
      "type": "string",
      "description": "Older/base snapshot ID"
    },
    "target_snapshot_id": {
      "type": "string",
      "description": "Newer/target snapshot ID"
    },
    "max_diff_chars": {
      "type": "integer",
      "default": 12000
    }
  },
  "required": [
    "app_id",
    "base_snapshot_id",
    "target_snapshot_id"
  ]
}

compare_current_to_version

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

Parameters3

app_id	string	required	The app ID
snapshot_id	string	required	Saved Version snapshot ID
max_diff_chars	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "snapshot_id": {
      "type": "string",
      "description": "Saved Version snapshot ID"
    },
    "max_diff_chars": {
      "type": "integer",
      "default": 12000
    }
  },
  "required": [
    "app_id",
    "snapshot_id"
  ]
}

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.

Parameters4

app_id	string	required	The app ID
snapshot_id	string	required	Saved Version snapshot ID
path	string	required	Virtual file path to restore
confirm	boolean	required

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "snapshot_id": {
      "type": "string",
      "description": "Saved Version snapshot ID"
    },
    "path": {
      "type": "string",
      "description": "Virtual file path to restore"
    },
    "confirm": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "app_id",
    "snapshot_id",
    "path",
    "confirm"
  ]
}

create_entity_schema

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

Parameters7

app_id	string	required	The app ID
entity	string	required	Entity name
schema	object	required	JSON schema object
relationships	array	optional
indexes	array	optional
metadata	object	optional
overwrite	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "entity": {
      "type": "string",
      "description": "Entity name"
    },
    "schema": {
      "type": "object",
      "description": "JSON schema object"
    },
    "relationships": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "default": []
    },
    "indexes": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "default": []
    },
    "metadata": {
      "type": "object",
      "default": {}
    },
    "overwrite": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "app_id",
    "entity",
    "schema"
  ]
}

update_entity_schema

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

Parameters7

app_id	string	required	The app ID
entity	string	required	Entity name
schema	object	required	Schema fields to set or merge
relationships	array	optional
indexes	array	optional
metadata	object	optional
merge	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "entity": {
      "type": "string",
      "description": "Entity name"
    },
    "schema": {
      "type": "object",
      "description": "Schema fields to set or merge"
    },
    "relationships": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "default": []
    },
    "indexes": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "default": []
    },
    "metadata": {
      "type": "object",
      "default": {}
    },
    "merge": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "app_id",
    "entity",
    "schema"
  ]
}

validate_entity_relationships

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

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

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.

Parameters5

app_id	string	required	The app ID
entity	string	required	Entity name
relationships	array	optional
indexes	array	optional
metadata	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "entity": {
      "type": "string",
      "description": "Entity name"
    },
    "relationships": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "default": []
    },
    "indexes": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "default": []
    },
    "metadata": {
      "type": "object",
      "default": {}
    }
  },
  "required": [
    "app_id",
    "entity"
  ]
}

list_secret_keys

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

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

set_secret

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

Parameters3

app_id	string	required	The app ID
key	string	required	Secret key name
value	string	required	Secret value to encrypt and store

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "key": {
      "type": "string",
      "description": "Secret key name"
    },
    "value": {
      "type": "string",
      "description": "Secret value to encrypt and store"
    }
  },
  "required": [
    "app_id",
    "key",
    "value"
  ]
}

delete_secret

Delete one app secret by key.

Parameters2

app_id	string	required	The app ID
key	string	required	Secret key name

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "key": {
      "type": "string",
      "description": "Secret key name"
    }
  },
  "required": [
    "app_id",
    "key"
  ]
}

list_integrations

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

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

configure_integration

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

Parameters4

app_id	string	required	The app ID
provider	string	required	Integration provider ID
config	object	required	Safe metadata only, such as workspace/team/name/email
is_active	boolean	optional	Set false to disconnect this integration metadata

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "provider": {
      "type": "string",
      "description": "Integration provider ID"
    },
    "config": {
      "type": "object",
      "description": "Safe metadata only, such as workspace/team/name/email"
    },
    "is_active": {
      "type": "boolean",
      "description": "Set false to disconnect this integration metadata",
      "default": true
    }
  },
  "required": [
    "app_id",
    "provider",
    "config"
  ]
}

list_ab_tests

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

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

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.

Parameters7

app_id	string	required	The app ID
name	string	required	Experiment name
page_name	string	required	Base route page that triggers the experiment
variants	array	required	At least two variants. Traffic must total 100.
goal_event_type	string	optional	Optional conversion goal type: entity_create, any, form_submit
goal_event_filter	object	optional	Optional goal filter, for example {'entity_name': 'Lead'}
is_active	boolean	optional	Whether to activate the test immediately

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "name": {
      "type": "string",
      "description": "Experiment name"
    },
    "page_name": {
      "type": "string",
      "description": "Base route page that triggers the experiment"
    },
    "variants": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "page_name": {
            "type": "string",
            "description": "Existing app page name or path"
          },
          "traffic_percent": {
            "type": "integer",
            "description": "Traffic percentage for this variant"
          }
        },
        "required": [
          "page_name",
          "traffic_percent"
        ]
      },
      "description": "At least two variants. Traffic must total 100."
    },
    "goal_event_type": {
      "type": "string",
      "description": "Optional conversion goal type: entity_create, any, form_submit"
    },
    "goal_event_filter": {
      "type": "object",
      "description": "Optional goal filter, for example {'entity_name': 'Lead'}"
    },
    "is_active": {
      "type": "boolean",
      "description": "Whether to activate the test immediately",
      "default": true
    }
  },
  "required": [
    "app_id",
    "name",
    "page_name",
    "variants"
  ]
}

update_ab_test

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

Parameters8

app_id	string	required	The app ID
test_id	string	required	A/B test ID
name	string	optional	Optional new name
page_name	string	optional	Optional new base route page
variants	array	optional	Optional replacement variants. Traffic must total 100.
is_active	boolean	optional	Optional active state
goal_event_type	string	optional	Optional conversion goal type
goal_event_filter	object	optional	Optional conversion goal filter

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "test_id": {
      "type": "string",
      "description": "A/B test ID"
    },
    "name": {
      "type": "string",
      "description": "Optional new name"
    },
    "page_name": {
      "type": "string",
      "description": "Optional new base route page"
    },
    "variants": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Optional replacement variants. Traffic must total 100."
    },
    "is_active": {
      "type": "boolean",
      "description": "Optional active state"
    },
    "goal_event_type": {
      "type": "string",
      "description": "Optional conversion goal type"
    },
    "goal_event_filter": {
      "type": "object",
      "description": "Optional conversion goal filter"
    }
  },
  "required": [
    "app_id",
    "test_id"
  ]
}

delete_ab_test

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

Parameters2

app_id	string	required	The app ID
test_id	string	required	A/B test ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "test_id": {
      "type": "string",
      "description": "A/B test ID"
    }
  },
  "required": [
    "app_id",
    "test_id"
  ]
}

get_ab_test_stats

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

Parameters2

app_id	string	required	The app ID
test_id	string	required	A/B test ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "test_id": {
      "type": "string",
      "description": "A/B test ID"
    }
  },
  "required": [
    "app_id",
    "test_id"
  ]
}

email_marketing_status

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

Parameters1

include_logs

boolean

optional

Include recent delivery logs

Raw schema

{
  "type": "object",
  "properties": {
    "include_logs": {
      "type": "boolean",
      "description": "Include recent delivery logs",
      "default": false
    }
  }
}

email_marketing_configure_sender

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

Parameters7

is_enabled	boolean	optional	Enable or disable the module at settings level
sender_name	string	optional	Display sender name
sender_email	string	optional	Sender email address used by the email provider
reply_to	string	optional	Reply-To email address
organization_name	string	optional	Organization name used in unsubscribe footer
postal_address	string	optional	Optional postal/contact address for compliance
default_timezone	string	optional	Default timezone for scheduling

Raw schema

{
  "type": "object",
  "properties": {
    "is_enabled": {
      "type": "boolean",
      "description": "Enable or disable the module at settings level"
    },
    "sender_name": {
      "type": "string",
      "description": "Display sender name"
    },
    "sender_email": {
      "type": "string",
      "description": "Sender email address used by the email provider"
    },
    "reply_to": {
      "type": "string",
      "description": "Reply-To email address"
    },
    "organization_name": {
      "type": "string",
      "description": "Organization name used in unsubscribe footer"
    },
    "postal_address": {
      "type": "string",
      "description": "Optional postal/contact address for compliance"
    },
    "default_timezone": {
      "type": "string",
      "description": "Default timezone for scheduling"
    }
  }
}

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.

Parameters4

template_id	string	required	Template/event id, e.g. user_joined
enabled	boolean	optional	Whether this automatic template is active
subject	string	optional	Email subject with {{variables}}
body_html	string	optional	HTML body with {{variables}}

Raw schema

{
  "type": "object",
  "properties": {
    "template_id": {
      "type": "string",
      "description": "Template/event id, e.g. user_joined"
    },
    "enabled": {
      "type": "boolean",
      "description": "Whether this automatic template is active"
    },
    "subject": {
      "type": "string",
      "description": "Email subject with {{variables}}"
    },
    "body_html": {
      "type": "string",
      "description": "HTML body with {{variables}}"
    }
  },
  "required": [
    "template_id"
  ]
}

email_marketing_create_broadcast

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

Parameters7

name	string	optional	Internal campaign name
subject	string	required	Email subject
body_html	string	required	HTML body. Unsubscribe is appended automatically.
filters	object	optional	Recipient filters: plans, roles, active_status, email_verified, min_apps, max_apps, has_published_app, search
scheduled_at	string	optional	Optional ISO datetime. If no timezone is included, timezone is used.
timezone	string	optional	Timezone for naive scheduled_at
send_now	boolean	optional	Send immediately after creating the campaign

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Internal campaign name"
    },
    "subject": {
      "type": "string",
      "description": "Email subject"
    },
    "body_html": {
      "type": "string",
      "description": "HTML body. Unsubscribe is appended automatically."
    },
    "filters": {
      "type": "object",
      "description": "Recipient filters: plans, roles, active_status, email_verified, min_apps, max_apps, has_published_app, search"
    },
    "scheduled_at": {
      "type": "string",
      "description": "Optional ISO datetime. If no timezone is included, timezone is used."
    },
    "timezone": {
      "type": "string",
      "description": "Timezone for naive scheduled_at",
      "default": "UTC"
    },
    "send_now": {
      "type": "boolean",
      "description": "Send immediately after creating the campaign",
      "default": false
    }
  },
  "required": [
    "subject",
    "body_html"
  ]
}

email_marketing_create_sequence

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

Parameters6

name	string	required	Sequence name
schedule_mode	string	required	fixed_dates uses each step.scheduled_at; day_offsets uses start_at + step day offsets
filters	object	optional	Recipient filters
start_at	string	optional	ISO datetime for day_offsets mode
timezone	string	optional
steps	array	required	Steps with subject, body_html, and either scheduled_at (fixed_dates) or day_offset/gap_days (day_offsets).

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Sequence name"
    },
    "schedule_mode": {
      "type": "string",
      "enum": [
        "fixed_dates",
        "day_offsets"
      ],
      "description": "fixed_dates uses each step.scheduled_at; day_offsets uses start_at + step day offsets"
    },
    "filters": {
      "type": "object",
      "description": "Recipient filters"
    },
    "start_at": {
      "type": "string",
      "description": "ISO datetime for day_offsets mode"
    },
    "timezone": {
      "type": "string",
      "default": "UTC"
    },
    "steps": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Steps with subject, body_html, and either scheduled_at (fixed_dates) or day_offset/gap_days (day_offsets)."
    }
  },
  "required": [
    "name",
    "schedule_mode",
    "steps"
  ]
}

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.

Parameters8

name	string	optional	Trigger name
enabled	boolean	optional
variable_name	string	required	Variable name, e.g. plan
from_value	string	optional	Previous value or empty wildcard
to_value	string	optional	New value or empty wildcard
subject	string	required	Email subject
body_html	string	required	HTML body. Unsubscribe is appended automatically.
filters	object	optional	Optional recipient filters

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Trigger name"
    },
    "enabled": {
      "type": "boolean",
      "default": true
    },
    "variable_name": {
      "type": "string",
      "description": "Variable name, e.g. plan"
    },
    "from_value": {
      "type": "string",
      "description": "Previous value or empty wildcard"
    },
    "to_value": {
      "type": "string",
      "description": "New value or empty wildcard"
    },
    "subject": {
      "type": "string",
      "description": "Email subject"
    },
    "body_html": {
      "type": "string",
      "description": "HTML body. Unsubscribe is appended automatically."
    },
    "filters": {
      "type": "object",
      "description": "Optional recipient filters"
    }
  },
  "required": [
    "variable_name",
    "subject",
    "body_html"
  ]
}

email_marketing_trigger_variable

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

Parameters5

user_id	string	required	Platform user id
variable_name	string	required	Variable name
from_value	string	optional	Previous value
to_value	string	optional	New value
context	object	optional	Extra template variables

Raw schema

{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string",
      "description": "Platform user id"
    },
    "variable_name": {
      "type": "string",
      "description": "Variable name"
    },
    "from_value": {
      "type": "string",
      "description": "Previous value"
    },
    "to_value": {
      "type": "string",
      "description": "New value"
    },
    "context": {
      "type": "object",
      "description": "Extra template variables"
    }
  },
  "required": [
    "user_id",
    "variable_name"
  ]
}

email_marketing_app_status

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

Parameters2

app_id	string	required	The app ID
include_logs	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "include_logs": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "app_id"
  ]
}

email_marketing_app_configure

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

Parameters8

app_id	string	required	The app ID
is_enabled	boolean	optional
default_contact_entity	string	optional	Entity to sync as contacts, e.g. Customer or Lead
default_email_field	string	optional	Field containing contact email
default_name_field	string	optional	Field containing contact name
sender_name	string	optional
sender_email	string	optional
reply_to	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "is_enabled": {
      "type": "boolean"
    },
    "default_contact_entity": {
      "type": "string",
      "description": "Entity to sync as contacts, e.g. Customer or Lead"
    },
    "default_email_field": {
      "type": "string",
      "description": "Field containing contact email"
    },
    "default_name_field": {
      "type": "string",
      "description": "Field containing contact name"
    },
    "sender_name": {
      "type": "string"
    },
    "sender_email": {
      "type": "string"
    },
    "reply_to": {
      "type": "string"
    }
  },
  "required": [
    "app_id"
  ]
}

email_marketing_app_sync_contacts

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

Parameters5

app_id	string	required	The app ID
entity_name	string	required	Entity name, e.g. Customer or Lead
email_field	string	optional
name_field	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "entity_name": {
      "type": "string",
      "description": "Entity name, e.g. Customer or Lead"
    },
    "email_field": {
      "type": "string",
      "default": "email"
    },
    "name_field": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 1000
    }
  },
  "required": [
    "app_id",
    "entity_name"
  ]
}

email_marketing_app_create_broadcast

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

Parameters8

app_id	string	required	The app ID
name	string	optional
subject	string	required
body_html	string	required
filters	object	optional	App contact filters such as source_entity, search, tags, field_equals
scheduled_at	string	optional
timezone	string	optional
send_now	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "name": {
      "type": "string"
    },
    "subject": {
      "type": "string"
    },
    "body_html": {
      "type": "string"
    },
    "filters": {
      "type": "object",
      "description": "App contact filters such as source_entity, search, tags, field_equals"
    },
    "scheduled_at": {
      "type": "string"
    },
    "timezone": {
      "type": "string",
      "default": "UTC"
    },
    "send_now": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "app_id",
    "subject",
    "body_html"
  ]
}

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.

Parameters8

app_id	string	required	The app ID
name	string	optional
enabled	boolean	optional
event_name	string	required	Event name, e.g. entity_created, Customer.created, order_paid
entity_name	string	optional	Optional entity filter
subject	string	required
body_html	string	required
filters	object	optional	Optional app contact filters

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "name": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean",
      "default": true
    },
    "event_name": {
      "type": "string",
      "description": "Event name, e.g. entity_created, Customer.created, order_paid"
    },
    "entity_name": {
      "type": "string",
      "description": "Optional entity filter"
    },
    "subject": {
      "type": "string"
    },
    "body_html": {
      "type": "string"
    },
    "filters": {
      "type": "object",
      "description": "Optional app contact filters"
    }
  },
  "required": [
    "app_id",
    "event_name",
    "subject",
    "body_html"
  ]
}

email_marketing_app_record_event

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

Parameters8

app_id	string	required	The app ID
event_name	string	required
email	string	optional	Contact email if no contact_id is known
contact_id	string	optional
entity_name	string	optional
record_id	string	optional
record	object	optional	Entity record fields for template variables and contact extraction
properties	object	optional	Extra event properties

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "event_name": {
      "type": "string"
    },
    "email": {
      "type": "string",
      "description": "Contact email if no contact_id is known"
    },
    "contact_id": {
      "type": "string"
    },
    "entity_name": {
      "type": "string"
    },
    "record_id": {
      "type": "string"
    },
    "record": {
      "type": "object",
      "description": "Entity record fields for template variables and contact extraction"
    },
    "properties": {
      "type": "object",
      "description": "Extra event properties"
    }
  },
  "required": [
    "app_id",
    "event_name"
  ]
}

email_marketing_app_create_workflow

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

Parameters7

app_id	string	required	The app ID
name	string	optional
enabled	boolean	optional
trigger_event_name	string	required	Event that enrolls a contact, e.g. Customer.created
trigger_entity_name	string	optional	Optional entity filter
steps	array	optional	Ordered workflow steps. Supported type values: email, wait, condition, split, goal.
definition	object	optional	Optional full workflow definition; steps can also be supplied here.

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "name": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean",
      "default": true
    },
    "trigger_event_name": {
      "type": "string",
      "description": "Event that enrolls a contact, e.g. Customer.created"
    },
    "trigger_entity_name": {
      "type": "string",
      "description": "Optional entity filter"
    },
    "steps": {
      "type": "array",
      "description": "Ordered workflow steps. Supported type values: email, wait, condition, split, goal.",
      "items": {
        "type": "object"
      }
    },
    "definition": {
      "type": "object",
      "description": "Optional full workflow definition; steps can also be supplied here."
    }
  },
  "required": [
    "app_id",
    "trigger_event_name"
  ]
}

email_marketing_app_create_sequence

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

Parameters7

app_id	string	required	The app ID
name	string	optional
schedule_mode	string	optional
start_at	string	optional	Sequence start date/time for day_offsets mode
timezone	string	optional
filters	object	optional	App contact filters
steps	array	required	Emails in order. Each step supports subject, body_html, scheduled_at, day_offset, or gap_days.

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "name": {
      "type": "string"
    },
    "schedule_mode": {
      "type": "string",
      "enum": [
        "fixed_dates",
        "day_offsets"
      ],
      "default": "day_offsets"
    },
    "start_at": {
      "type": "string",
      "description": "Sequence start date/time for day_offsets mode"
    },
    "timezone": {
      "type": "string",
      "default": "UTC"
    },
    "filters": {
      "type": "object",
      "description": "App contact filters"
    },
    "steps": {
      "type": "array",
      "description": "Emails in order. Each step supports subject, body_html, scheduled_at, day_offset, or gap_days.",
      "items": {
        "type": "object"
      }
    }
  },
  "required": [
    "app_id",
    "steps"
  ]
}

email_marketing_app_report

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

Parameters4

app_id	string	required	The app ID
include_events	boolean	optional
limit	integer	optional
segment_limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "include_events": {
      "type": "boolean",
      "default": true
    },
    "limit": {
      "type": "integer",
      "default": 50
    },
    "segment_limit": {
      "type": "integer",
      "default": 25
    }
  },
  "required": [
    "app_id"
  ]
}

email_marketing_app_create_segment

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

Parameters4

app_id	string	required	The app ID
name	string	required
filters	object	required	Segment filters. Supports rules with field/operator/value plus opened/clicked/sent behavior fields.
sample_limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "name": {
      "type": "string"
    },
    "filters": {
      "type": "object",
      "description": "Segment filters. Supports rules with field/operator/value plus opened/clicked/sent behavior fields."
    },
    "sample_limit": {
      "type": "integer",
      "default": 10
    }
  },
  "required": [
    "app_id",
    "name",
    "filters"
  ]
}

email_marketing_app_contact_profile

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

Parameters2

app_id	string	required	The app ID
contact	string	required	Contact id or email address

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "contact": {
      "type": "string",
      "description": "Contact id or email address"
    }
  },
  "required": [
    "app_id",
    "contact"
  ]
}

email_marketing_app_deliverability

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

Parameters1

app_id

string

required

The app ID

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    }
  },
  "required": [
    "app_id"
  ]
}

email_marketing_app_process_queue

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

Parameters2

app_id	string	required	The app ID
max_jobs	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "max_jobs": {
      "type": "integer",
      "default": 50
    }
  },
  "required": [
    "app_id"
  ]
}

email_marketing_app_queue_status

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

Parameters3

app_id	string	required	The app ID
limit	integer	optional
status	string	optional	Optional queue status filter

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "limit": {
      "type": "integer",
      "default": 50
    },
    "status": {
      "type": "string",
      "description": "Optional queue status filter"
    }
  },
  "required": [
    "app_id"
  ]
}

email_marketing_app_suppress_contact

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

Parameters5

app_id	string	required	The app ID
email	string	required
reason	string	optional
source	string	optional
metadata	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string",
      "description": "The app ID"
    },
    "email": {
      "type": "string"
    },
    "reason": {
      "type": "string",
      "default": "manual"
    },
    "source": {
      "type": "string",
      "default": "mcp"
    },
    "metadata": {
      "type": "object"
    }
  },
  "required": [
    "app_id",
    "email"
  ]
}

Install

Tools (92)

create_appagency_create_clientagency_list_clientsagency_create_client_appagency_create_claim_linkagency_get_claim_statusupdate_apppublish_app

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://finestructure.ai/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "fine-structure": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://finestructure.ai/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.