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 Read this account's creative workspace, images, gallery, automation runs and publication status
post
/api/mcp/tools/read_creative
Oct 19, 2026
02c50ed5fd70
Revision changes
info
endpoint added