Fine Structure Tools API
Per-tool REST operations (one per Fine Structure tool)
Operations 368
Showing the first 250 of 368. The full set is in the contract, and via get_provider_operations.
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_app_links
Return editor, preview, published path, subdomain, and custom-domain links plus…
#
POST
/api/mcp/tools/list_app_domains
List an app's platform path, subdomain, and configured custom domain with…
#
POST
/api/mcp/tools/set_app_subdomain
Set or clear the app platform subdomain - the '.' host Fine Structure already…
#
POST
/api/mcp/tools/check_subdomain_available
Check whether a platform subdomain can be claimed before calling…
#
POST
/api/mcp/tools/add_custom_domain
Attach or replace the app custom domain through the same Fine Structure Studio…
#
POST
/api/mcp/tools/get_domain_verification
Return the exact DNS records and instructions required to verify and route the…
#
POST
/api/mcp/tools/check_domain_verification
Check Fine Structure custom-domain verification and SSL status for the…
#
POST
/api/mcp/tools/set_primary_domain
Set which app host should be treated as primary for generated links and…
#
POST
/api/mcp/tools/remove_custom_domain
Remove the configured custom domain from the app and clean up the platform-side…
#
POST
/api/mcp/tools/get_domain_ssl_status
Return SSL/certificate status and pending certificate validation DNS records…
#
POST
/api/mcp/tools/configure_domain_redirects
Configure custom-domain redirect policy: primary domain, optional www/root…
#
POST
/api/mcp/tools/list_apps
List owned and accepted Studio-shared applications, newest activity first
#
POST
/api/mcp/tools/get_app_detail
Deep introspection of an app: entities, pages, settings, integrations…
#
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/get_app_analytics
Traffic analytics for an app's published site over a chosen window: total…
#
POST
/api/mcp/tools/list_saved_versions
List restorable Saved Versions for an app, including versions created by MCP…
#
POST
/api/mcp/tools/validate_change_set
Validate current app files plus staged change set files before applying
#
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…
#
POST
/api/mcp/tools/inspect_preview
Return server-side preview context: URLs, persisted runtime/network errors…
#
POST
/api/mcp/tools/get_app_security_context
Return safe security context for one owned app: owner id/email, Studio…
#
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…
#
POST
/api/mcp/tools/invoke_function
Run a backend function of an owned app exactly like the HTTP route and return…
#
POST
/api/mcp/tools/create_platform_request
Open a request to the Fine Structure platform team: a bug, a feature request or…
#
POST
/api/mcp/tools/get_platform_request
One platform request with its full history: team replies, status changes (open…
#
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…
#
POST
/api/mcp/tools/update_platform_request
Platform team only: set the status of a request (open | triaged | in_progress |…
#
POST
/api/mcp/tools/block_app_member
Block a person who signed up to the app, like the Block button in the app's…
#
POST
/api/mcp/tools/verify_app_member
Mark the email address of a person who signed up to the app as confirmed, the…
#
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…
#
POST
/api/mcp/tools/compare_current_to_version
Compare the current app files to a Saved Version and return compact per-file…
#
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/validate_entity_relationships
Validate entity relationship metadata and *_id references against existing…
#
POST
/api/mcp/tools/list_integrations
List supported integrations and safe connected integration metadata 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…
#
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_app_status
Inspect app-scoped Email Marketing for one generated app: settings, contacts…
#
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…
#
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…
#
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…
#
POST
/api/mcp/tools/email_marketing_app_create_sequence
Create an app-scoped email sequence using fixed dates or day offsets between…
#
POST
/api/mcp/tools/email_marketing_app_report
Read app-scoped Email Marketing reporting: delivery counts, open/click rates…
#
POST
/api/mcp/tools/email_marketing_app_create_segment
Create an app-scoped saved audience segment using field, tag, and behavior…
#
POST
/api/mcp/tools/email_marketing_app_contact_profile
Read a contact profile with email delivery, tracking, app-event, workflow…
#
POST
/api/mcp/tools/email_marketing_app_deliverability
Read provider readiness, bounce/complaint rates, suppression reasons, and…
#
POST
/api/mcp/tools/email_marketing_app_process_queue
Process due app-scoped automation workflow runs and email queue jobs with…
#
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…
#
POST
/api/mcp/tools/list_media_capabilities
Discovery for the media tools: the active image model and remaining image…
#
POST
/api/mcp/tools/generate_image
Generate one marketing image (ad creative, thumbnail, hero, social graphic) and…
#
POST
/api/mcp/tools/generate_slideshow
Write a TikTok/Instagram-style slideshow: hook, per-slide copy, caption, and…
#
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…
#
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…
#
POST
/api/mcp/tools/read_creative
Read this account's creative workspace, images, gallery, automation runs and…
#
POST
/api/mcp/tools/configure_creative
Edit private creative work, plan copy, generate collections, revise slides and…
#
POST
/api/mcp/tools/publish_creative
Publish or schedule creative content, send it to a social draft inbox or manage…
#
POST
/api/mcp/tools/get_app_metadata
Read the saved public HTML-shell identity: name, description, language and…
#
POST
/api/mcp/tools/set_app_metadata
Update public HTML-shell metadata immediately, without AI, code edits…
#
POST
/api/mcp/tools/preview_saved_version
Prepare an isolated read-only Saved Version preview, if enabled by the…
#
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…
#
POST
/api/mcp/tools/create_agent
Create an autonomous AI agent on the user's Fine Structure account: a standing…
#
POST
/api/mcp/tools/list_agents
List the AI agents on the user's account with id, name, role, status and…
#
POST
/api/mcp/tools/list_agent_tasks
List scheduled tasks for one agent (or the whole account), including schedule…
#
POST
/api/mcp/tools/get_agent_whatsapp
Read the WhatsApp state of the connected account: whether the owner's phone is…
#
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…
#
POST
/api/mcp/tools/attach_agent_whatsapp
Connect a platform WhatsApp number to one of the account's agents, so the owner…
#
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…
#
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_agent
Read one agent: name, role, description, persona (its standing instructions)…
#
POST
/api/mcp/tools/update_agent
Edit an agent's name, role, description or persona (its standing instructions)
#
POST
/api/mcp/tools/list_agent_activity
What the account's agents did, newest first: each run with its agent, status…
#
POST
/api/mcp/tools/list_agent_approvals
Actions the agents are holding until the owner approves them, such as a message…
#
POST
/api/mcp/tools/get_credit_balance
The account's plan and both balances: build credits, which pay for creating and…
#
POST
/api/mcp/tools/update_agent_task
Change a scheduled task: title, instructions, schedule (same shape as…
#
POST
/api/mcp/tools/run_agent_task_now
Start one run of a scheduled task now, outside its schedule
#
POST
/api/mcp/tools/stop_agent_task
Stop a task now: pause its schedule and cancel the run in progress, which stops…
#
POST
/api/mcp/tools/cancel_agent_run
Cancel one run in progress, for example a reply the agent is still working on
#
POST
/api/mcp/tools/list_agent_goals
An agent's goals: objective, success criteria, plan, status, progress, current…
#
POST
/api/mcp/tools/update_agent_goal
Change a goal's title, objective, success criteria, plan, iteration cap or…
#
POST
/api/mcp/tools/archive_agent_goal
Retire a goal: its runner stops and never runs again, and the goal stays…
#
POST
/api/mcp/tools/run_agent_goal_now
Work one step of a goal now, outside its interval, under the agent's…
#
POST
/api/mcp/tools/list_org_goals
The owner's company-wide goals, the shared objectives every agent aligns to…
#
POST
/api/mcp/tools/update_org_goal
Change a company-wide goal's title, objective, status (active, paused, done…
#
POST
/api/mcp/tools/list_org_goal_updates
The progress notes agents wrote on a company-wide goal, newest first
#
POST
/api/mcp/tools/list_agent_triggers
What starts an agent on its own: event, schedule, watch and webhook triggers…
#
POST
/api/mcp/tools/create_agent_trigger
Add a trigger that starts the agent with these instructions: event (event_type…
#
POST
/api/mcp/tools/update_agent_trigger
Change a trigger's name, type, event, source, instructions, schedule or status…
#
POST
/api/mcp/tools/archive_agent_trigger
Retire a trigger: it never starts the agent again and stays readable
#
POST
/api/mcp/tools/run_agent_trigger_now
Fire a trigger once now as a test: the agent runs its instructions under its…
#
POST
/api/mcp/tools/list_agent_memories
What an agent has learned and kept: long-term facts and insights, newest first…
#
POST
/api/mcp/tools/list_team_templates
Ready-made agent teams (for example a sales or a support company) that…
#
POST
/api/mcp/tools/create_agent_team
Create a whole team of agents from a template, wired to work together…
#
POST
/api/mcp/tools/list_agent_templates
Ready-made single agent templates: role, description and suggested persona, for…
#
POST
/api/mcp/tools/list_connections
The account's connected accounts and services (each mailbox, Drive view, MCP…
#
POST
/api/mcp/tools/list_connection_catalog
Every service the platform can connect, with whether this account has connected…
#
POST
/api/mcp/tools/get_connection_access
Which of the owner's agents and apps may use one connection (from…
#
POST
/api/mcp/tools/get_connection_status
Status of the account-level connections: Facebook, Google Drive, TikTok and the…
#
POST
/api/mcp/tools/list_facebook_ad_accounts
The ad accounts the connected Facebook account reaches, and which of them…
#
POST
/api/mcp/tools/search_connectable_apps
Third-party apps an agent can be connected to (thousands, through the apps…
#
POST
/api/mcp/tools/list_connectable_app_tools
What an agent could do with one third-party app once it is connected: its…
#
POST
/api/mcp/tools/get_make_migration_report
Read every scenario in the owner's connected Make account and grade what moves…
#
POST
/api/mcp/tools/list_event_connections
Incoming-events sources: external systems that send events to the account (a…
#
POST
/api/mcp/tools/list_event_connection_events
The latest 100 events a source received and what each did: status, step…
#
POST
/api/mcp/tools/list_event_connection_revisions
The saved versions of a source's configuration
#
POST
/api/mcp/tools/preview_event_connection
Dry run: show what a source would do with a sample event (its identity, which…
#
POST
/api/mcp/tools/pause_event_connection
Pause an incoming-events source: events that arrive are kept and wait, and none…
#
POST
/api/mcp/tools/get_marketing_capabilities
Discover the complete Fine Structure /audiences marketing engine: contacts…
#
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)…
#
POST
/api/mcp/tools/get_voice_capabilities
Discover Fine Structure business voice agents: flows, templates, voices, rules…
#
POST
/api/mcp/tools/read_voice
Read scoped voice configuration, live calls and transcripts, lead data…
#
POST
/api/mcp/tools/configure_voice
Build drafts/templates, simulate, qualify leads, update captured request stages…
#
POST
/api/mcp/tools/execute_voice
Operate live voice agents: publish, pause, change routing, connect webhook…
#
POST
/api/mcp/tools/list_voice_campaigns
List the account's outbound voice campaigns: name, status (draft, running…
#
POST
/api/mcp/tools/get_voice_campaign
Read one outbound voice campaign: its full document (agent, outcomes, caller…
#
POST
/api/mcp/tools/get_voice_campaign_options
What a campaign may use: the account's caller numbers, its published voice…
#
POST
/api/mcp/tools/estimate_voice_campaign
Expected cost and duration of a campaign document for a number of contacts…
#
POST
/api/mcp/tools/get_voice_campaign_stats
Results of a campaign: totals, answer and success rates, cost, outcomes, A/B…
#
POST
/api/mcp/tools/list_voice_campaign_contacts
The campaign's contacts with their status, attempts, outcome and summary…
#
POST
/api/mcp/tools/export_voice_campaign_results
Every contact of a campaign as CSV text: phone, name, status, attempts…
#
POST
/api/mcp/tools/list_voice_campaign_rehearsals
The campaign's latest rehearsal calls to the owner's own phone, with what was…
#
POST
/api/mcp/tools/add_voice_campaign_contacts
Add people to the call list of a campaign that is not running (a draft or a…
#
POST
/api/mcp/tools/add_voice_campaign_do_not_call
Put a number on the account's do-not-call list, permanently
#
POST
/api/mcp/tools/pause_voice_campaign
Pause a running campaign: no new calls start, calls already on the line finish
#
POST
/api/mcp/tools/stop_voice_campaign
Stop a running or paused campaign for good: no new calls start, and it cannot…
#
POST
/api/mcp/tools/lodging_create_property
Set up a new lodging property: a complete property-management app with rooms…
#
POST
/api/mcp/tools/lodging_get_property
The property behind an app: its configuration (name, type, country, currency…
#
POST
/api/mcp/tools/lodging_get_property_settings
The property's settings: name, type, country, currency, language, timezone, the…
#
POST
/api/mcp/tools/lodging_get_today
Today at the property, in its own timezone: arrivals, departures, guests in…
#
POST
/api/mcp/tools/lodging_get_calendar
Rooms by night for 7, 14 or 28 nights from start (default today): each room's…
#
POST
/api/mcp/tools/lodging_list_guests
The guest book, paged: contact details, stays, last stay and preferences
#
POST
/api/mcp/tools/lodging_list_rooms
Rooms, paged, with type, capacity, amenities, floor, wing, accessibility and…
#
POST
/api/mcp/tools/lodging_list_balances
Who owes money: the largest open balances across the property, and the account…
#
POST
/api/mcp/tools/lodging_get_report
The daily report for day (default today): rooms sold, held and available that…
#
POST
/api/mcp/tools/lodging_list_people
Who can be responsible for work: the property's staff, the owner and its AI…
#
POST
/api/mcp/tools/lodging_get_building
Every room with its floor, wing and readiness, and who is arriving, in house…
#
POST
/api/mcp/tools/lodging_search
Search reservations, guests and rooms by any word: a guest name, email, phone…
#
POST
/api/mcp/tools/lodging_get_stay
One reservation in full: guest, room, dates, party, status, agreed times…
#
POST
/api/mcp/tools/lodging_get_guest
One guest: contact details, preferences, staff notes, consent and opt-outs, and…
#
POST
/api/mcp/tools/lodging_get_day_review
What is still open before the business day ends: arrivals not checked in…
#
POST
/api/mcp/tools/lodging_export_ledger
The account entries of one business day (day) or one reservation (stay_id) as…
#
POST
/api/mcp/tools/lodging_suggest_room_names
The next count room names in the property's own naming pattern (numbers…
#
POST
/api/mcp/tools/lodging_update_room
Change one room: name, room type, capacity (max_guests), amenities, floor…
#
POST
/api/mcp/tools/lodging_hold_room
Block a room for maintenance from arrival to departure (departure is the first…
#
POST
/api/mcp/tools/lodging_release_room_hold
End a maintenance hold early, so the room can be booked again
#
POST
/api/mcp/tools/lodging_check_availability
Free rooms for arrival to departure (departure is the check-out day) and a…
#
POST
/api/mcp/tools/lodging_create_booking
Book a room: room_id from lodging_check_availability, arrival, departure…
#
POST
/api/mcp/tools/lodging_change_stay
Move a reservation to another room, change its dates or its party, in two calls
#
POST
/api/mcp/tools/lodging_set_stay_times
Agree a check-in or check-out time for one reservation (HH:MM), or clear it…
#
POST
/api/mcp/tools/lodging_get_booking_inbox
New bookings from the booking site, online payments that need review, and holds…
#
POST
/api/mcp/tools/lodging_mark_booking_inbox_seen
Mark the booking-site inbox as seen up to until, the newest confirmed_at the…
#
POST
/api/mcp/tools/lodging_import_guests
Add guests to the guest book from a list (name, email, phone, preferences)
#
POST
/api/mcp/tools/lodging_add_task
Create a housekeeping or maintenance task: title, optionally a room, a due date…
#
POST
/api/mcp/tools/lodging_update_task
Change a task: title, room, due date, status (open, in_progress, done) or who…
#
POST
/api/mcp/tools/lodging_create_stayover_tasks
Create today's daily room-service task for every occupied room
#
POST
/api/mcp/tools/lodging_close_day
Record that the business day was reviewed: who closed it, when, and what was…
#
POST
/api/mcp/tools/lodging_get_pricing
Rate plans (nightly price, minimum nights, cancellation terms, rooms, seasonal…
#
Specifications
Schemas & Data
JSONSchema
https://artifacts.apis.io/finestructure-ai/json-schema/finestructure-ai-agent-schema.json
JSONSchema
https://artifacts.apis.io/finestructure-ai/json-schema/finestructure-ai-outcome-schema.json
JSONSchema
https://artifacts.apis.io/finestructure-ai/json-schema/finestructure-ai-speech-schema.json
JSONSchema
https://artifacts.apis.io/finestructure-ai/json-schema/finestructure-ai-variant-schema.json
JSONSchema
https://artifacts.apis.io/finestructure-ai/json-schema/finestructure-ai-window-schema.json