Search skmtc…
⌘K
Docs
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Generate
Filter operations
bridge
1
discovery
2
mcp
1
tools
145
post
/api/mcp/tools/create_app
Create a new application from a natural language prompt
post
/api/mcp/tools/agency_create_client
Agency mode only
post
/api/mcp/tools/agency_list_clients
Agency mode only
post
/api/mcp/tools/agency_create_client_app
Agency mode only
post
/api/mcp/tools/agency_create_claim_link
Agency mode only
post
/api/mcp/tools/agency_get_claim_status
Agency mode only
post
/api/mcp/tools/update_app
Update an existing application with a new prompt
post
/api/mcp/tools/publish_app
Publish an app - freeze current state and make it live at a URL
post
/api/mcp/tools/get_platform_guide
Return a machine-readable Fine Structure / FSe2 guide for AI agents
post
/api/mcp/tools/get_recommended_workflow
Return the recommended MCP tool sequence for a task type
post
/api/mcp/tools/get_job_status
Poll the status of an async generation job
post
/api/mcp/tools/get_app_status
Get app overview: files, published state, URL, active jobs
post
/api/mcp/tools/get_app_links
Return editor, preview, published path, subdomain, and custom-domain links plus whether each works for anonymous visi...
post
/api/mcp/tools/list_app_domains
List an app's platform path, subdomain, and configured custom domain with verification, SSL, primary-domain, redirect...
post
/api/mcp/tools/set_app_subdomain
Set or clear the app platform subdomain - the '<subdomain>.<base domain>' host Fine Structure already serves the app on
post
/api/mcp/tools/check_subdomain_available
Check whether a platform subdomain can be claimed before calling set_app_subdomain
post
/api/mcp/tools/add_custom_domain
Attach or replace the app custom domain through the same Fine Structure Studio custom-domain flow
post
/api/mcp/tools/get_domain_verification
Return the exact DNS records and instructions required to verify and route the app custom domain
post
/api/mcp/tools/check_domain_verification
Check Fine Structure custom-domain verification and SSL status for the configured custom domain, then save the latest...
post
/api/mcp/tools/set_primary_domain
Set which app host should be treated as primary for generated links and custom-domain redirects
post
/api/mcp/tools/remove_custom_domain
Remove the configured custom domain from the app and clean up the platform-side hostname registration when possible
post
/api/mcp/tools/get_domain_ssl_status
Return SSL/certificate status and pending certificate validation DNS records for the app custom domain
post
/api/mcp/tools/configure_domain_redirects
Configure custom-domain redirect policy: primary domain, optional www/root redirect, and HTTPS enforcement
post
/api/mcp/tools/list_apps
List owned and accepted Studio-shared applications, newest activity first
post
/api/mcp/tools/get_app_files
Get the file tree for an app with paths and byte sizes
post
/api/mcp/tools/read_app_file
Read one source file from an app's virtual filesystem
post
/api/mcp/tools/read_app_files
Read several source files from an app's virtual filesystem
post
/api/mcp/tools/write_app_file
Create or replace one file in an app's virtual filesystem
post
/api/mcp/tools/patch_app_file
Patch one file by replacing exact text
post
/api/mcp/tools/rename_app_file
Rename or move one app source file atomically
post
/api/mcp/tools/get_app_detail
Deep introspection of an app: entities, pages, settings, integrations, environment variables, and file structure
post
/api/mcp/tools/get_entities
Get all entity (data model) schemas for an app, with record counts
post
/api/mcp/tools/query_entity
Query app data records for one entity with optional exact-match filters
post
/api/mcp/tools/seed_entity
Compatibility tool for starter-record creation
post
/api/mcp/tools/create_entity_records
Create/insert records in one app entity
post
/api/mcp/tools/update_entity_record
Compatibility tool that updates one record by ID
post
/api/mcp/tools/update_entity_records
Update exact records
post
/api/mcp/tools/delete_entity_records
Delete exact records by ID or exact-match filters
post
/api/mcp/tools/get_pages
Get all pages in an app with their file paths and sizes
post
/api/mcp/tools/get_errors
Get recent runtime errors for an app (last 20)
post
/api/mcp/tools/get_app_analytics
Traffic analytics for an app's published site over a chosen window: total views, unique visitors, daily series, top p...
post
/api/mcp/tools/get_preview_url
Return editor preview and published/public URLs for an app
post
/api/mcp/tools/list_saved_versions
List restorable Saved Versions for an app, including versions created by MCP writes
post
/api/mcp/tools/restore_saved_version
Compatibility endpoint for full Saved Version restore
post
/api/mcp/tools/create_change_set
Create a staged file change set
post
/api/mcp/tools/add_file_change
Stage one file upsert or delete inside a change set
post
/api/mcp/tools/validate_change_set
Validate current app files plus staged change set files before applying
post
/api/mcp/tools/apply_change_set
Apply a staged change set to the app
post
/api/mcp/tools/discard_change_set
Discard a pending staged change set without changing app files
post
/api/mcp/tools/validate_app
Run deterministic app checks: syntax, imports, routes/pages, entity schemas, missing entities, and recorded runtime e...
post
/api/mcp/tools/inspect_preview
Return server-side preview context: URLs, persisted runtime/network errors, static clickable candidates, pages, and e...
post
/api/mcp/tools/get_app_security_context
Return safe security context for one owned app: owner id/email, Studio collaborators, generated-app members, route po...
post
/api/mcp/tools/set_route_policy
Create or update a server-owned route policy for a generated app route
post
/api/mcp/tools/set_function_policy
Create or update the server-owned access policy of a backend function (functions/<name>.js)
post
/api/mcp/tools/invoke_function
Run a backend function of an owned app exactly like the HTTP route and return its status and JSON
post
/api/mcp/tools/create_platform_request
Open a request to the Fine Structure platform team: a bug, a feature request or a question about the platform itself ...
post
/api/mcp/tools/get_platform_request
One platform request with its full history: team replies, status changes (open | triaged | in_progress | needs_info |...
post
/api/mcp/tools/list_platform_requests
Your account's platform requests, newest activity first
post
/api/mcp/tools/reply_platform_request
Add a reply or a finding to one of your platform requests without opening a new one, e.g
post
/api/mcp/tools/update_platform_request
Platform team only: set the status of a request (open | triaged | in_progress | needs_info | deployed | wont_fix), at...
post
/api/mcp/tools/set_entity_policy
Replace server-side entity access policy
post
/api/mcp/tools/list_app_members
List generated-app runtime users/members for an app
post
/api/mcp/tools/invite_app_member
Provision a generated-app runtime member with a role
post
/api/mcp/tools/update_app_member_role
Update a generated-app runtime member role
post
/api/mcp/tools/remove_app_member
Remove a generated-app runtime member
post
/api/mcp/tools/get_app_security_audit
Read recent server-side security audit events for an app
post
/api/mcp/tools/compare_saved_versions
Compare two Saved Versions and return per-file additions, removals, modifications, and compact diffs
post
/api/mcp/tools/compare_current_to_version
Compare the current app files to a Saved Version and return compact per-file diffs
post
/api/mcp/tools/restore_file_from_version
Restore one file from a Saved Version instead of restoring the entire app
post
/api/mcp/tools/create_entity_schema
Create an entity schema file in entities/<Entity>.json
post
/api/mcp/tools/update_entity_schema
Replace or shallow-merge an existing entity schema file
post
/api/mcp/tools/validate_entity_relationships
Validate entity relationship metadata and *_id references against existing entity schemas
post
/api/mcp/tools/update_entity_metadata
Set relationship/index metadata on an entity schema
post
/api/mcp/tools/list_secret_keys
List secret key names for an app
post
/api/mcp/tools/set_secret
Create or update one encrypted app secret
post
/api/mcp/tools/delete_secret
Delete one app secret by key
post
/api/mcp/tools/list_integrations
List supported integrations and safe connected integration metadata for an app
post
/api/mcp/tools/configure_integration
Store safe non-secret integration metadata for an app
post
/api/mcp/tools/list_ab_tests
List the platform A/B tests configured for an app
post
/api/mcp/tools/create_ab_test
Create a native Fine Structure A/B test between existing app pages
post
/api/mcp/tools/update_ab_test
Update a native A/B test, including active state, variants, traffic, and conversion goal
post
/api/mcp/tools/delete_ab_test
Delete a native A/B test from an app
post
/api/mcp/tools/get_ab_test_stats
Get views, unique visitors, conversions, and conversion rates for an A/B test
post
/api/mcp/tools/email_marketing_status
Admin only
post
/api/mcp/tools/email_marketing_configure_sender
Admin only
post
/api/mcp/tools/email_marketing_update_template
Admin only
post
/api/mcp/tools/email_marketing_create_broadcast
Admin only
post
/api/mcp/tools/email_marketing_create_sequence
Admin only
post
/api/mcp/tools/email_marketing_create_variable_trigger
Admin only
post
/api/mcp/tools/email_marketing_trigger_variable
Admin only
post
/api/mcp/tools/email_marketing_app_status
Inspect app-scoped Email Marketing for one generated app: settings, contacts, campaigns, event triggers, and recent e...
post
/api/mcp/tools/email_marketing_app_configure
Configure isolated Email Marketing settings for a generated app
post
/api/mcp/tools/email_marketing_app_sync_contacts
Sync an app entity table into app-scoped Email Marketing contacts
post
/api/mcp/tools/email_marketing_app_create_broadcast
Create an app-scoped broadcast to contacts synced from that generated app, optionally scheduled or sent now
post
/api/mcp/tools/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
post
/api/mcp/tools/email_marketing_app_record_event
Record an app event and send matching app-scoped Email Marketing triggers
post
/api/mcp/tools/email_marketing_app_create_workflow
Create an app-scoped automation workflow with email, wait, condition, split, and goal steps
post
/api/mcp/tools/email_marketing_app_create_sequence
Create an app-scoped email sequence using fixed dates or day offsets between emails
post
/api/mcp/tools/email_marketing_app_report
Read app-scoped Email Marketing reporting: delivery counts, open/click rates, and recent tracking events
post
/api/mcp/tools/email_marketing_app_create_segment
Create an app-scoped saved audience segment using field, tag, and behavior filters
post
/api/mcp/tools/email_marketing_app_contact_profile
Read a contact profile with email delivery, tracking, app-event, workflow, suppression, and unsubscribe timeline
post
/api/mcp/tools/email_marketing_app_deliverability
Read provider readiness, bounce/complaint rates, suppression reasons, and recent deliverability risk events
post
/api/mcp/tools/email_marketing_app_process_queue
Process due app-scoped automation workflow runs and email queue jobs with locks, retries, and suppression checks
post
/api/mcp/tools/email_marketing_app_queue_status
Inspect app-scoped Email Marketing queue jobs and per-status counts
post
/api/mcp/tools/email_marketing_app_suppress_contact
Suppress an app contact email after a bounce, complaint, manual block, provider block, or unsubscribe
post
/api/mcp/tools/list_media_capabilities
Discovery for the media tools: the active image model and remaining image allowance, the video models this account ma...
post
/api/mcp/tools/generate_image
Generate one marketing image (ad creative, thumbnail, hero, social graphic) and return a public URL
post
/api/mcp/tools/estimate_video_cost
Price a video render before generating it
post
/api/mcp/tools/generate_video
Generate an AI video from a text prompt
post
/api/mcp/tools/get_video_status
Poll one video job by id
post
/api/mcp/tools/list_video_jobs
List this account's own video jobs, newest first
post
/api/mcp/tools/generate_slideshow
Write a TikTok/Instagram-style slideshow: hook, per-slide copy, caption, and hashtags, in any supported language
post
/api/mcp/tools/render_slideshow_images
Render the images for a slideshow whose script was already written and approved
post
/api/mcp/tools/get_slideshow
Fetch one slideshow: its script, render status (script_ready, rendering, ready, render_failed), and the image URL of ...
post
/api/mcp/tools/list_slideshows
List this account's slideshows, newest first, without slide bodies
post
/api/mcp/tools/get_creative_capabilities
Discover the complete Creative Studio workspace, copy, image references, slide editing, gallery, social publishing an...
post
/api/mcp/tools/read_creative
Read this account's creative workspace, images, gallery, automation runs and publication status
post
/api/mcp/tools/configure_creative
Edit private creative work, plan copy, generate collections, revise slides and manage reference images
post
/api/mcp/tools/publish_creative
Publish or schedule creative content, send it to a social draft inbox or manage recurring generation/publishing
post
/api/mcp/tools/get_app_metadata
Read the saved public HTML-shell identity: name, description, language and image URLs/dimensions
post
/api/mcp/tools/set_app_metadata
Update public HTML-shell metadata immediately, without AI, code edits, publishing or Saved Versions
post
/api/mcp/tools/preview_saved_version
Prepare an isolated read-only Saved Version preview, if enabled by the deployment
post
/api/mcp/tools/configure_email_domain_dns
Configure sending DNS for an already-owned managed email domain on an owned app
post
/api/mcp/tools/set_agent_owner_relay
Set the owner's consent for one owned agent to relay reports from another owned agent (or all sources with '*')
post
/api/mcp/tools/create_agent
Create an autonomous AI agent on the user's Fine Structure account: a standing worker, not a chat session
post
/api/mcp/tools/list_agents
List the AI agents on the user's account with id, name, role, status and FineMail address
post
/api/mcp/tools/schedule_agent_task
Create a scheduled task for one of the user's agents
post
/api/mcp/tools/list_agent_tasks
List scheduled tasks for one agent (or the whole account), including schedule, status and next_run_at
post
/api/mcp/tools/get_agent_whatsapp
Read the WhatsApp state of the connected account: whether the owner's phone is verified, which platform numbers they ...
post
/api/mcp/tools/start_owner_phone_verification
Send a 6-digit code over WhatsApp to the ACCOUNT OWNER's own phone
post
/api/mcp/tools/confirm_owner_phone_verification
Confirm the 6-digit code the owner received on WhatsApp from start_owner_phone_verification
post
/api/mcp/tools/attach_agent_whatsapp
Connect a platform WhatsApp number to one of the account's agents, so the owner can message that number and reach tha...
post
/api/mcp/tools/detach_agent_whatsapp
Disconnect the owner's WhatsApp route from a platform number
post
/api/mcp/tools/list_agent_conversations
List recent visible conversations belonging to one of your agents
post
/api/mcp/tools/send_agent_message
Talk to an existing agent or assign it work using its normal tools, memory, permissions and team
post
/api/mcp/tools/get_agent_conversation
Read visible messages, answers and result links in an owned agent's conversation
post
/api/mcp/tools/get_agent_task
Check a durable task returned by send_agent_message or list_agent_tasks
post
/api/mcp/tools/get_marketing_capabilities
Discover the complete Fine Structure /audiences marketing engine: contacts, segments, email and WhatsApp, templates, ...
post
/api/mcp/tools/read_marketing
Read, query, preview, validate or export owned marketing data
post
/api/mcp/tools/configure_marketing
Prepare inert drafts, local templates, folders and preferences
post
/api/mcp/tools/execute_marketing
Operate live marketing: contacts/imports (may trigger existing automations), campaigns, schedules, reports, official ...
post
/api/mcp/tools/get_voice_capabilities
Discover Fine Structure business voice agents: flows, templates, voices, rules, permissions, confirmed leads, qualifi...
post
/api/mcp/tools/read_voice
Read scoped voice configuration, live calls and transcripts, lead data, analytics or provider number inventory
post
/api/mcp/tools/configure_voice
Build drafts/templates, simulate, qualify leads, update captured request stages with version checking and propose opt...
post
/api/mcp/tools/execute_voice
Operate live voice agents: publish, pause, change routing, connect webhook destinations, retry handoffs or call the v...
tools
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Changes to Prepare an isolated read-only Saved Version preview, if enabled by the deployment
post
/api/mcp/tools/preview_saved_version
Oct 19, 2026
02c50ed5fd70
Revision changes
info
endpoint added