MCP 服务器

Fine Structure

ai.finestructure/fine-structure
云与基础设施 开发者工具 公开且可连接 MCP 2026-07-28

此 MCP 可以做什么

Builds and hosts full-stack applications from prompts and supports agent communication through WhatsApp and email.

add_custom_domain
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.
可能执行破坏性操作 可访问外部资源
输入模式
{'type': 'object', 'required': ['app_id', 'domain'], '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'}}}
add_file_change
Add File Change
Stage one file upsert or delete inside a change set. Does not modify the live app until apply_change_set. Paths follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.
输入模式
{'type': 'object', 'required': ['app_id', 'change_set_id', 'path'], 'properties': {'path': {'type': 'string', 'description': 'Virtual file path'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'content': {'type': 'string', 'default': '', 'description': 'Complete file contents for upsert'}, 'file_type': {'type': 'string', 'default': '', 'description': 'Optional file type override'}, 'operation': {'enum': ['upsert', 'delete'], 'type': 'string', 'default': 'upsert'}, 'change_set_id': {'type': 'string', 'description': 'Change set ID'}}}
agency_create_claim_link
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.
输入模式
{'type': 'object', 'required': ['app_id', 'client_email'], 'properties': {'note': {'type': 'string', 'default': '', 'description': 'Optional internal note'}, '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', 'default': '', 'description': 'Optional client display name'}, 'claim_expires_in_days': {'type': 'integer', 'default': 14, 'description': 'Claim link lifetime, 1-90 days'}, 'keep_agent_collaborator': {'type': 'boolean', 'default': True, 'description': 'Invite agent as editor after claim'}}}
agency_create_client
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.
输入模式
{'type': 'object', 'required': ['client_email'], 'properties': {'note': {'type': 'string', 'default': '', 'description': 'Optional internal note for the agency'}, 'client_email': {'type': 'string', 'description': 'Client email that will be allowed to claim projects'}, 'client_full_name': {'type': 'string', 'default': '', 'description': 'Optional client display name'}}}
agency_create_client_app
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.
输入模式
{'type': 'object', 'required': ['client_email', 'name', 'prompt'], 'properties': {'name': {'type': 'string', 'description': 'Name for the app (1-100 chars)'}, 'note': {'type': 'string', 'default': '', 'description': 'Optional internal client/project note'}, 'prompt': {'type': 'string', 'description': 'Detailed description of the app to build'}, 'description': {'type': 'string', 'default': '', 'description': 'Optional short app description'}, 'client_email': {'type': 'string', 'description': 'Client email allowed to claim ownership'}, 'client_full_name': {'type': 'string', 'default': '', 'description': 'Optional client display name'}, 'claim_expires_in_days': {'type': 'integer', 'default': 14, 'description': 'Claim link lifetime, 1-90 days'}, 'keep_agent_collaborator': {'type': 'boolean', 'default': True, 'description': 'After claim, invite the agent back as an editor collaborator'}}}
agency_get_claim_status
Agency: Get Claim Status
Agency mode only. Inspect one handoff status without exposing the raw claim token.
只读 幂等
输入模式
{'type': 'object', 'required': ['handoff_id'], 'properties': {'handoff_id': {'type': 'string', 'description': 'Handoff ID returned by agency_create_claim_link or agency_create_client_app'}}}
agency_list_clients
Agency: List Clients
Agency mode only. List client records and app handoff status for the authenticated agent.
只读 幂等
输入模式
{'type': 'object', 'properties': {'include_handoffs': {'type': 'boolean', 'default': True, 'description': 'Include claim links status without raw tokens'}}}
apply_change_set
Apply Change Set
Apply a staged change set to the app. Creates a Saved Version before applying. Blocks on validation errors unless force=true.
输入模式
{'type': 'object', 'required': ['app_id', 'change_set_id'], 'properties': {'force': {'type': 'boolean', 'default': False, 'description': 'Apply even if validation has errors'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'change_set_id': {'type': 'string', 'description': 'Change set ID'}}}
attach_agent_whatsapp
Attach Agent Whatsapp
Connect a platform WhatsApp number to one of the account's agents, so the owner can message that number and reach that agent. Requires the owner to be verified first. Take phone_number_id from get_agent_whatsapp. A number already used by another account is still valid to connect: it answers only this owner's verified phone.
可访问外部资源
输入模式
{'type': 'object', 'required': ['agent_id', 'phone_number_id'], 'properties': {'agent_id': {'type': 'string', 'description': 'The agent that should answer on this number.'}, 'phone_number_id': {'type': 'string', 'description': 'phone_number_id from get_agent_whatsapp claimable_numbers.'}}}
check_domain_verification
Check Domain Verification
Check Fine Structure custom-domain verification and SSL status for the configured custom domain, then save the latest status.
可访问外部资源
输入模式
{'type': 'object', 'required': ['app_id'], '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."}}}
check_subdomain_available
Check Subdomain Available
Check whether a platform subdomain can be claimed before calling set_app_subdomain. Returns available plus a status of available, invalid, reserved, taken, current, or empty, with the exact reason. Pass app_id (an app you own) to have that app's own current subdomain reported as 'current' instead of 'taken'.
只读 幂等
输入模式
{'type': 'object', 'required': ['subdomain'], 'properties': {'app_id': {'type': 'string', 'description': "Optional ID of an app you own. When supplied, this app's own subdomain reports as 'current' instead of 'taken'."}, 'subdomain': {'type': 'string', 'description': 'Subdomain label to check'}}}
compare_current_to_version
Compare Current To Version
Compare the current app files to a Saved Version and return compact per-file diffs.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id', 'snapshot_id'], '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}}}
compare_saved_versions
Compare Saved Versions
Compare two Saved Versions and return per-file additions, removals, modifications, and compact diffs.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id', 'base_snapshot_id', 'target_snapshot_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'max_diff_chars': {'type': 'integer', 'default': 12000}, 'base_snapshot_id': {'type': 'string', 'description': 'Older/base snapshot ID'}, 'target_snapshot_id': {'type': 'string', 'description': 'Newer/target snapshot ID'}}}
configure_domain_redirects
Configure Domain Redirects
Configure custom-domain redirect policy: primary domain, optional www/root redirect, and HTTPS enforcement.
可访问外部资源
输入模式
{'type': 'object', 'required': ['app_id', 'primary_domain'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'force_https': {'type': 'boolean', 'default': True, 'description': 'Redirect HTTP custom-domain requests to HTTPS'}, 'redirect_www': {'type': 'boolean', 'default': True, 'description': 'Redirect the www/root counterpart to primary_domain'}, 'primary_domain': {'type': 'string', 'description': 'Canonical primary domain, for example example.com'}}}
configure_integration
Configure Integration
Store safe non-secret integration metadata for an app. Use set_secret for API keys/tokens.
输入模式
{'type': 'object', 'required': ['app_id', 'provider', 'config'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'config': {'type': 'object', 'description': 'Safe metadata only, such as workspace/team/name/email'}, 'provider': {'type': 'string', 'description': 'Integration provider ID'}, 'is_active': {'type': 'boolean', 'default': True, 'description': 'Set false to disconnect this integration metadata'}}}
confirm_owner_phone_verification
Confirm Owner Phone Verification
Confirm the 6-digit code the owner received on WhatsApp from start_owner_phone_verification. On success the owner is verified: agents can message them, and platform numbers become connectable.
输入模式
{'type': 'object', 'required': ['phone', 'code'], 'properties': {'code': {'type': 'string', 'description': 'The 6-digit code from the WhatsApp message.'}, 'phone': {'type': 'string', 'description': 'The same phone number the code was sent to.'}, 'region': {'type': 'string', 'description': 'Optional ISO region hint, matching the one used when sending.'}}}
create_ab_test
Create A/B 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.
可访问外部资源
输入模式
{'type': 'object', 'required': ['app_id', 'name', 'page_name', 'variants'], 'properties': {'name': {'type': 'string', 'description': 'Experiment name'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'variants': {'type': 'array', 'items': {'type': 'object', 'required': ['page_name', 'traffic_percent'], 'properties': {'page_name': {'type': 'string', 'description': 'Existing app page name or path'}, 'traffic_percent': {'type': 'integer', 'description': 'Traffic percentage for this variant'}}}, 'description': 'At least two variants. Traffic must total 100.'}, 'is_active': {'type': 'boolean', 'default': True, 'description': 'Whether to activate the test immediately'}, 'page_name': {'type': 'string', 'description': 'Base route page that triggers the experiment'}, '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'}"}}}
create_agent
Create Agent
Create an autonomous AI agent on the user's Fine Structure account: a standing worker, not a chat session. It gets the platform's default safe tool policy and its own email address, it can read and write the app database, and once the owner phone is verified (see get_agent_whatsapp) it can message its owner on WhatsApp and by email through the platform system channels. Pair it with schedule_agent_task for recurring work such as following up new leads on WhatsApp each morning, watching an app for runtime errors, or sending a weekly summary. Messaging anyone other than the verified owner requires a channel the owner connects in the Fine Structure Studio.
可访问外部资源
输入模式
{'type': 'object', 'required': ['role', 'description'], 'properties': {'name': {'type': 'string', 'description': "Agent display name (e.g. 'Lead Follow-up'). Auto-derived from role when omitted."}, 'role': {'type': 'string', 'description': "Short role label (e.g. 'sales assistant')"}, 'app_id': {'type': 'string', 'description': 'Optional app to attach the agent to; account-level when omitted'}, 'persona': {'type': 'string', 'description': 'Optional working style and tone instructions for the agent'}, 'description': {'type': 'string', 'description': 'What this agent is responsible for, one or two sentences'}}}
create_app
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.
输入模式
{'type': 'object', 'required': ['name', 'prompt'], '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', 'default': '', 'description': 'Optional short description'}}}
create_change_set
Create Change Set
Create a staged file change set. Add multiple file changes, validate them as one app state, then apply atomically.
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'label': {'type': 'string', 'description': 'Optional short label'}, 'app_id': {'type': 'string', 'description': 'The app ID'}}}
create_entity_records
Create Entity Records
Create/insert records in one app entity. Executes directly for the authenticated app owner and returns the created record ids.
输入模式
{'type': 'object', 'required': ['app_id', 'entity', 'records'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'entity': {'type': 'string', 'description': 'Entity name'}, 'reason': {'type': 'string', 'default': '', 'description': 'Why these records should be created'}, 'records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Records to create'}, 'expected_count': {'type': 'integer', 'description': 'Optional safety check; the write aborts if the record count differs'}}}
create_entity_schema
Create Entity Schema
Create an entity schema file in entities/<Entity>.json. Creates a Saved Version before writing.
输入模式
{'type': 'object', 'required': ['app_id', 'entity', 'schema'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'entity': {'type': 'string', 'description': 'Entity name'}, 'schema': {'type': 'object', 'description': 'JSON schema object'}, 'indexes': {'type': 'array', 'items': {'type': 'object'}, 'default': []}, 'metadata': {'type': 'object', 'default': {}}, 'overwrite': {'type': 'boolean', 'default': False}, 'relationships': {'type': 'array', 'items': {'type': 'object'}, 'default': []}}}
create_platform_request
Create Platform Request
Open a request to the Fine Structure platform team: a bug, a feature request or a question about the platform itself (not about the user's app). Use it when something in the platform blocks you instead of working around it. Give a reproduction the team can run (invoke_function / curl / the exact tool call and result), what you expected, and how the team will know it is closed. Credential-looking values are redacted. Returns request_id and a Studio URL; the team's replies, status changes and deployments come back through get_platform_request / list_platform_requests. Limits: 20 per account per day, 32 KB.
输入模式
{'type': 'object', 'required': ['type', 'title', 'body'], 'properties': {'body': {'type': 'string', 'description': 'Free text, markdown allowed: context, impact, what you tried'}, 'type': {'enum': ['bug', 'feature', 'question'], 'type': 'string'}, 'title': {'type': 'string', 'description': 'One line, what is wrong or missing'}, 'app_id': {'type': 'string', 'description': 'Optional: the app where it showed up'}, 'expected': {'type': 'string', 'description': 'What should have happened'}, 'severity': {'enum': ['blocker', 'high', 'normal', 'low'], 'type': 'string', 'default': 'normal'}, 'acceptance': {'type': 'string', 'description': 'How the team will know it is closed'}, 'attachments': {'type': 'array', 'items': {'type': 'string'}, 'default': [], 'description': 'Optional app file paths or log ids'}, 'reproduction': {'type': 'string', 'description': 'Steps, invoke_function calls or curl commands that reproduce it'}}}
delete_ab_test
Delete A/B Test
Delete a native A/B test from an app. Creates a Saved Version before the change.
可能执行破坏性操作 可访问外部资源
输入模式
{'type': 'object', 'required': ['app_id', 'test_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'test_id': {'type': 'string', 'description': 'A/B test ID'}}}
delete_entity_records
Delete Entity Records
Delete exact records by ID or exact-match filters. Executes directly for the authenticated app owner; pass expected_count as a safety check to abort on a mismatch.
可能执行破坏性操作
输入模式
{'type': 'object', 'required': ['app_id', 'entity'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'entity': {'type': 'string', 'description': 'Entity name'}, 'reason': {'type': 'string', 'default': '', 'description': 'Why these records should be deleted'}, 'filters': {'oneOf': [{'type': 'object'}, {'type': 'array', 'items': {'type': 'object'}}], 'description': 'One exact-match selector or a list of exact-match selectors'}, 'record_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact record IDs to delete'}, 'expected_count': {'type': 'integer', 'description': 'Required match count safety check, when known'}}}
delete_secret
Delete Secret
Delete one app secret by key.
可能执行破坏性操作
输入模式
{'type': 'object', 'required': ['app_id', 'key'], 'properties': {'key': {'type': 'string', 'description': 'Secret key name'}, 'app_id': {'type': 'string', 'description': 'The app ID'}}}
detach_agent_whatsapp
Detach Agent Whatsapp
Disconnect the owner's WhatsApp route from a platform number. Removes only this account's route; other accounts sharing the number keep theirs.
可能执行破坏性操作 可访问外部资源
输入模式
{'type': 'object', 'required': ['phone_number_id'], 'properties': {'phone_number_id': {'type': 'string', 'description': 'The number to disconnect, from get_agent_whatsapp.'}}}
discard_change_set
Discard Change Set
Discard a pending staged change set without changing app files.
可能执行破坏性操作
输入模式
{'type': 'object', 'required': ['app_id', 'change_set_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'change_set_id': {'type': 'string', 'description': 'Change set ID'}}}
get_ab_test_stats
Get A/B Test Stats
Get views, unique visitors, conversions, and conversion rates for an A/B test.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id', 'test_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'test_id': {'type': 'string', 'description': 'A/B test ID'}}}
get_agent_whatsapp
Get Agent Whatsapp
Read the WhatsApp state of the connected account: whether the owner's phone is verified, which platform numbers they can connect, and which conversations already route to which agent. Call this first whenever the user asks to talk to an agent on WhatsApp, and repeat its next_step to them.
只读 幂等
输入模式
{'type': 'object', 'properties': {'agent_id': {'type': 'string', 'description': "Optional: report only this agent's WhatsApp state."}}}
get_app_analytics
Get App Analytics
Traffic analytics for an app's published site over a chosen window: total views, unique visitors, daily series, top pages, top referrer domains and device split.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'days': {'type': 'integer', 'default': 7, 'description': 'Window in days (1-90, default 7)'}, 'app_id': {'type': 'string', 'description': 'The app ID'}}}
get_app_detail
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.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
get_app_files
Get App Files
Get the file tree for an app with paths and byte sizes.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
get_app_links
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.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
get_app_security_audit
Get App Security Audit
Read recent server-side security audit events for an app.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'limit': {'type': 'integer', 'default': 100}, 'app_id': {'type': 'string', 'description': 'The app ID'}}}
get_app_security_context
Get App Security Context
Return safe security context for one owned app: owner id/email, Studio collaborators, generated-app members, route policies, entity policies, function policies, and recent security audit entries. Does not return secrets and does not grant access to other apps.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'audit_limit': {'type': 'integer', 'default': 50}}}
get_app_status
Get App Status
Get app overview: files, published state, URL, active jobs.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
get_domain_ssl_status
Get Domain SSL Status
Return SSL/certificate status and pending certificate validation DNS records for the app custom domain.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', 'required': ['app_id'], '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."}}}
get_domain_verification
Get Domain Verification
Return the exact DNS records and instructions required to verify and route the app custom domain.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], '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."}}}
get_entities
Get Entities
Get all entity (data model) schemas for an app, with record counts. Each entity has fields, types, and relationships.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
get_errors
Get Errors
Get recent runtime errors for an app (last 20). Useful for diagnosing issues before updating.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'description': 'Max errors to return (default 20)'}, 'app_id': {'type': 'string', 'description': 'The app ID'}}}
get_job_status
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.
只读 幂等
输入模式
{'type': 'object', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'description': 'The job_id returned by create_app or update_app'}}}
get_pages
Get Pages
Get all pages in an app with their file paths and sizes.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
get_platform_guide
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.
只读 幂等
输入模式
{'type': 'object', 'properties': {'app_id': {'type': 'string', 'description': 'Optional app ID. If provided, the guide includes a safe app context summary.'}, 'sections': {'type': 'array', 'items': {'enum': ['ab_testing', 'agency', 'agents', 'app_code', 'checklists', 'data_model', 'direct_file_edit', 'domains', 'file_model', 'functions', 'generation', 'media', 'overview', 'platform_requests', 'publishing', 'saas', 'safety', 'sdk', 'secrets_integrations', 'security', 'validation'], 'type': 'string'}, 'description': 'Optional subset of guide sections to return.'}, 'task_type': {'type': 'string', 'description': 'Optional task hint, for example edit_app, direct_file_edit, seed_data, or publish_app.'}}}
get_platform_request
Get Platform Request
One platform request with its full history: team replies, status changes (open | triaged | in_progress | needs_info | deployed | wont_fix) and what was deployed (commit, time). Pass since=<ISO timestamp> to get only the events after it.
只读 幂等
输入模式
{'type': 'object', 'required': ['request_id'], 'properties': {'since': {'type': 'string', 'description': 'Optional ISO timestamp: only events after it'}, 'request_id': {'type': 'string'}}}
get_preview_url
Get Preview URL
Return editor preview and published/public URLs for an app.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
get_recommended_workflow
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.
只读 幂等
输入模式
{'type': 'object', 'properties': {'goal': {'type': 'string', 'default': '', 'description': "Optional short description of the user's goal."}, 'app_id': {'type': 'string', 'description': 'Optional app ID. If provided, the workflow includes a safe app context summary.'}, 'task_type': {'enum': ['ab_test', 'agency_client_app', 'backend_function', 'create_app', 'direct_file_edit', 'domain_setup', 'edit_app', 'fix_runtime_error', 'generate_media', 'inspect_preview', 'publish_app', 'saas_setup', 'schema_change', 'secrets_integration', 'security_setup', 'seed_data', 'unknown', 'version_restore'], 'type': 'string', 'default': 'unknown', 'description': 'The task type to plan.'}}}
inspect_preview
Inspect Live Preview
Return server-side preview context: URLs, persisted runtime/network errors, static clickable candidates, pages, and explicit live-browser availability.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'route': {'type': 'string', 'default': '', 'description': 'Optional route to inspect'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'auth_as': {'type': 'string', 'default': '', 'description': 'Optional auth simulation: anonymous'}, 'auth_as_role': {'type': 'string', 'default': '', 'description': 'Optional app role simulation, e.g. staff/admin/customer'}}}
invite_app_member
Invite App Member
Provision a generated-app runtime member with a role. This does not create a Studio collaborator, and the owner role cannot be assigned. password is required: ask the account owner which password the member should get. This tool never generates one, because a generated password would come back in the result and that is a live credential in the conversation transcript.
输入模式
{'type': 'object', 'required': ['app_id', 'email', 'role', 'password'], 'properties': {'role': {'type': 'string', 'description': 'App role, e.g. admin/staff/customer'}, 'email': {'type': 'string', 'description': 'Member email'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'password': {'type': 'string', 'description': 'The password this member signs in with, chosen by the account owner. Required, and never echoed back in the result.'}, 'full_name': {'type': 'string', 'default': ''}}}
invoke_function
Invoke Function
Run a backend function of an owned app exactly like the HTTP route and return its status and JSON. caller='owner' runs as the app owner; caller='anonymous' first evaluates the function policy as a public visitor and returns the 401/403 decision without running when access would be denied. Use it to verify a function (secrets, outbound calls, policy) before wiring it into the app.
输入模式
{'type': 'object', 'required': ['app_id', 'function'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'caller': {'enum': ['owner', 'anonymous'], 'type': 'string', 'default': 'owner'}, 'params': {'type': 'object', 'default': {}, 'description': 'JSON body passed to the function'}, 'headers': {'type': 'object', 'default': {}, 'description': 'Optional extra request headers to simulate, e.g. a webhook secret header'}, 'function': {'type': 'string', 'description': 'Function name, e.g. probe'}}}
list_ab_tests
List A/B Tests
List the platform A/B tests configured for an app.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
list_agents
List Agents
List the AI agents on the user's account with id, name, role, status and FineMail address.
只读 幂等
输入模式
{'type': 'object', 'properties': {'app_id': {'type': 'string', 'description': 'Optional filter by attached app'}}}
list_agent_tasks
List Agent Tasks
List scheduled tasks for one agent (or the whole account), including schedule, status and next_run_at.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'description': 'Max tasks to return (1-100)'}, 'status': {'type': 'string', 'description': 'Optional status filter: draft, active, paused, archived'}, 'agent_id': {'type': 'string', 'description': 'Optional agent id filter'}}}
list_app_domains
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.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
list_app_members
List App Members
List generated-app runtime users/members for an app. This is separate from Studio project collaborators.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
list_apps
List Apps
List applications owned by the authenticated user, newest activity first. Returns up to `limit` apps per call plus the total count; page with `offset` when the account has more.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'description': 'Max apps to return (1-200)'}, 'offset': {'type': 'integer', 'default': 0, 'description': 'Apps to skip, for paging'}}}
list_integrations
List Integrations
List supported integrations and safe connected integration metadata for an app. Tokens/secrets are never returned.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
list_platform_requests
List Platform Requests
Your account's platform requests, newest activity first. Call it at the start of a session with since=<the updated_date you last saw> to learn what changed: replies, needs_info questions to answer, deployments with their commit. Filters: app_id, status.
只读 幂等
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 100}, 'scope': {'enum': ['mine', 'all'], 'type': 'string', 'default': 'mine', 'description': "'all' = every account (platform team only)"}, 'since': {'type': 'string', 'description': 'Optional ISO timestamp: only requests touched after it, each with changes_since'}, 'app_id': {'type': 'string', 'description': 'Optional app filter'}, 'status': {'enum': ['open', 'triaged', 'in_progress', 'needs_info', 'deployed', 'wont_fix'], 'type': 'string'}}}
list_saved_versions
List Saved Versions
List restorable Saved Versions for an app, including versions created by MCP writes.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
list_secret_keys
List Secret Keys
List secret key names for an app. Secret values are never returned.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
patch_app_file
Patch App File
Patch one file by replacing exact text. Safer than full overwrite for targeted edits. Creates a Saved Version before changing content. Paths follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.
输入模式
{'type': 'object', 'required': ['app_id', 'path', 'old_text', 'new_text'], 'properties': {'path': {'type': 'string', 'description': 'Virtual file path'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'new_text': {'type': 'string', 'description': 'Replacement text'}, 'old_text': {'type': 'string', 'description': 'Exact existing text to replace'}, 'replace_all': {'type': 'boolean', 'default': False, 'description': 'Replace all matches instead of the first match'}}}
publish_app
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.
可访问外部资源
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID to publish'}, 'access_mode': {'enum': ['infer', 'public_open', 'public_auth', 'private', 'keep'], 'type': 'string', '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.'}, 'make_public': {'type': 'boolean', 'description': 'Optional explicit override for whether published URLs are publicly reachable. Prefer access_mode when possible.'}, 'auth_required': {'type': 'boolean', 'description': 'Optional explicit override for generated-app login requirement. Prefer access_mode when possible.'}}}
query_entity
Query Entity
Query app data records for one entity with optional exact-match filters.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id', 'entity'], 'properties': {'sort': {'type': 'string', 'default': '-created_date', 'description': 'Sort field, prefix with - for descending'}, 'limit': {'type': 'integer', 'default': 100, 'description': 'Max records to return'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'entity': {'type': 'string', 'description': 'Entity name, for example Patient'}, 'offset': {'type': 'integer', 'default': 0, 'description': 'Pagination offset'}, 'filters': {'type': 'object', 'default': {}, 'description': 'Exact-match field filters'}}}
read_app_file
Read App File
Read one source file from an app's virtual filesystem. Paths follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id', 'path'], 'properties': {'path': {'type': 'string', 'description': 'Virtual file path, for example pages/Home.jsx'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'max_chars': {'type': 'integer', 'default': 200000, 'description': 'Maximum content characters to return'}}}
read_app_files
Read App Files
Read several source files from an app's virtual filesystem. Paths follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id', 'paths'], 'properties': {'paths': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Virtual file paths to read'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'max_chars_per_file': {'type': 'integer', 'default': 100000, 'description': 'Maximum characters per file'}}}
remove_app_member
Remove App Member
Remove a generated-app runtime member.
可能执行破坏性操作
输入模式
{'type': 'object', 'required': ['app_id', 'user_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'user_id': {'type': 'string', 'description': 'Generated app user id'}}}
remove_custom_domain
Remove Custom Domain
Remove the configured custom domain from the app and clean up the platform-side hostname registration when possible.
可能执行破坏性操作 可访问外部资源
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'domain': {'type': 'string', 'description': 'Optional configured custom domain. If omitted, removes the current custom domain.'}}}
rename_app_file
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.
输入模式
{'type': 'object', 'required': ['app_id', 'old_path', 'new_path'], 'properties': {'force': {'type': 'boolean', 'default': False, 'description': 'Apply even if validation reports blocking errors'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'new_path': {'type': 'string', 'description': 'New virtual file path'}, 'old_path': {'type': 'string', 'description': 'Existing virtual file path to rename'}, 'overwrite': {'type': 'boolean', 'default': False, 'description': 'Allow replacing an existing file at new_path'}}}
reply_platform_request
Reply Platform Request
Add a reply or a finding to one of your platform requests without opening a new one, e.g. to answer a needs_info question (that reopens it).
输入模式
{'type': 'object', 'required': ['request_id', 'body'], 'properties': {'body': {'type': 'string', 'description': 'The answer or finding (markdown allowed, credentials are redacted)'}, 'as_team': {'type': 'boolean', 'default': False, 'description': 'Platform team only: reply as the team (mails the requester)'}, 'request_id': {'type': 'string'}}}
restore_file_from_version
Restore File From Version
Restore one file from a Saved Version instead of restoring the entire app. Creates a Saved Version before changing the file. Paths follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.
可能执行破坏性操作
输入模式
{'type': 'object', 'required': ['app_id', 'snapshot_id', 'path', 'confirm'], 'properties': {'path': {'type': 'string', 'description': 'Virtual file path to restore'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'confirm': {'type': 'boolean', 'default': False}, 'snapshot_id': {'type': 'string', 'description': 'Saved Version snapshot ID'}}}
schedule_agent_task
Schedule Agent Task
Create a scheduled task for one of the user's agents. Supported schedule types: once (run_at ISO local time + timezone), interval (interval_minutes 5-1440), hourly, daily (time HH:MM + timezone), weekly (time + timezone + days_of_week 0=Sunday..6), cron (5-field expression + timezone), manual (only runs on demand). Returns the normalized schedule and the computed next_run_at so you can read the fire time back to the user in their timezone.
可访问外部资源
输入模式
{'type': 'object', 'required': ['agent_id', 'title', 'instructions', 'schedule'], 'properties': {'title': {'type': 'string', 'description': 'Short task title'}, 'activate': {'type': 'boolean', 'default': True, 'description': 'Start the schedule immediately (true) or save as draft (false)'}, 'agent_id': {'type': 'string', 'description': 'The agent id (from create_agent or list_agents)'}, 'max_runs': {'type': 'integer', 'default': 0, 'description': 'Optional cap on total runs (0 = unlimited)'}, 'schedule': {'type': 'object', 'description': 'Schedule object, e.g. {"type":"daily","time":"08:30","timezone":"Asia/Jerusalem"} or {"type":"weekly","time":"09:00","timezone":"Asia/Jerusalem","days_of_week":[0]} or {"type":"once","run_at":"2026-08-20T09:00","timezone":"Asia/Jerusalem"}'}, 'instructions': {'type': 'string', 'description': 'What the agent should do on each run, written as instructions to the agent'}}}
seed_entity
Seed Entity Records
Compatibility tool for starter-record creation. Inserts directly for the authenticated app owner; by default it only seeds an empty entity (skip_if_not_empty).
输入模式
{'type': 'object', 'required': ['app_id', 'entity', 'records'], 'properties': {'mode': {'enum': ['append', 'skip_if_not_empty'], 'type': 'string', 'default': 'skip_if_not_empty', 'description': 'append always inserts; skip_if_not_empty inserts only when the entity is empty'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'entity': {'type': 'string', 'description': 'Entity name'}, 'reason': {'type': 'string', 'default': '', 'description': 'Why these records should be created'}, 'records': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Records to insert'}}}
set_app_subdomain
Set App Subdomain
Set or clear the app platform subdomain - the '<subdomain>.<base domain>' host Fine Structure already serves the app on. Runs the same ownership, format, reserved-name and uniqueness checks as the Studio subdomain field because it calls the same model function. Replacing a subdomain takes effect immediately and creates NO redirect: the previous name stops resolving to this app and is released for anyone to claim. Pass an empty subdomain to clear it. For a domain the user owns, use add_custom_domain instead.
可能执行破坏性操作 可访问外部资源
输入模式
{'type': 'object', 'required': ['app_id', 'subdomain'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'subdomain': {'type': 'string', 'description': 'Subdomain label: 3-32 characters, lowercase letters, digits and hyphens, no leading or trailing hyphen, not a reserved platform name. Empty string clears the subdomain.'}}}
set_entity_policy
Set Entity Policy
Replace server-side entity access policy. Optional action rules override read/write roles and can allow public create without public read, update, or delete. Omitting rules replaces any existing action rules with read/write role behavior.
可能执行破坏性操作 可访问外部资源
输入模式
{'type': 'object', 'required': ['app_id', 'entity', 'read', 'write'], 'properties': {'read': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Roles allowed to read when rules are omitted'}, 'rules': {'type': 'object', 'required': ['rules'], 'properties': {'rules': {'type': 'array', 'items': {'type': 'object', 'required': ['actions', 'subject'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'actions': {'type': 'array', 'items': {'enum': ['create', 'read', 'update', 'delete', 'write'], 'type': 'string'}, 'minItems': 1}, 'subject': {'type': 'object', 'required': ['roles'], 'properties': {'roles': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1}}, 'additionalProperties': False}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'minItems': 1}, 'version': {'enum': [1], 'type': 'integer'}}, 'description': 'Nonempty unconditional action/role rules. No matching rule denies access. Include owner/admin actions explicitly. Record conditions are not supported by this MCP input.', 'additionalProperties': False}, 'write': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Roles allowed to write when rules are omitted'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'entity': {'type': 'string', 'description': 'Entity name, e.g. Booking'}}}
set_function_policy
Set Function Policy
Create or update the server-owned access policy of a backend function (functions/<name>.js). Without a policy a function answers only to the app owner's Studio token (401 for app visitors and webhooks). Recipes: anonymous checkout step or inbound webhook/IPN -> require_auth=false; signed-in members -> require_auth=true + allowed_roles (e.g. ['authenticated'] or ['admin','staff']); webhook with a shared secret -> require_secret=true + secret_name (an app secret) that the caller sends in secret_header. allowed_hosts fences the function's outbound network to those hosts plus the platform backend; omit it for open egress.
输入模式
{'type': 'object', 'required': ['app_id', 'function', 'require_auth'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'function': {'type': 'string', 'description': 'Function name, e.g. takbull_create (file functions/takbull_create.js)'}, 'secret_name': {'type': 'string', 'default': '', 'description': 'Name of the app secret holding the shared value (set_secret)'}, 'require_auth': {'type': 'boolean', 'default': True, 'description': 'false = anonymous visitors and external callers may invoke'}, 'sdk_identity': {'enum': ['caller', 'app'], 'type': 'string', 'description': "Whose identity the SDK inside the function uses. 'caller' (default): the function reads data as whoever called it, so an anonymous call sees only what anonymous may read. 'app': the SDK acts as the app owner on THIS app's entities (a checkout or payment IPN that must load/update orders whose read policy is owner/admin/staff); the caller still counts as anonymous for rate limits, audit and X-FSe2-Caller-Type. Owner-only. Omit to keep the stored value"}, 'allowed_hosts': {'type': 'array', 'items': {'type': 'string'}, 'description': "Outbound egress allow-list of host[:port] entries, e.g. ['api.takbull.co.il']. Omit to keep the stored list; pass [] to open egress again"}, 'allowed_roles': {'type': 'array', 'items': {'type': 'string'}, 'default': [], 'description': "App roles allowed when require_auth is true; 'authenticated' = any signed-in app member"}, 'secret_header': {'type': 'string', 'default': 'x-fse2-secret', 'description': 'Header the caller sends the shared secret in'}, 'require_secret': {'type': 'boolean', 'default': False, 'description': 'Caller must send a shared secret header (webhooks)'}}}
set_primary_domain
Set Primary Domain
Set which app host should be treated as primary for generated links and custom-domain redirects.
可访问外部资源
输入模式
{'type': 'object', 'required': ['app_id', 'domain'], '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.'}}}
set_route_policy
Set Route Policy
Create or update a server-owned route policy for a generated app route.
可能执行破坏性操作 可访问外部资源
输入模式
{'type': 'object', 'required': ['app_id', 'route', 'require_auth', 'allowed_roles'], 'properties': {'route': {'type': 'string', 'description': 'Route or wildcard route, e.g. /admin/*'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'redirect_to': {'type': 'string', 'default': '/Login'}, 'require_auth': {'type': 'boolean', 'default': True}, 'allowed_roles': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Allowed app roles'}}}
set_secret
Set Secret
Create or update one encrypted app secret. The secret value is never returned.
可能执行破坏性操作
输入模式
{'type': 'object', 'required': ['app_id', 'key', 'value'], 'properties': {'key': {'type': 'string', 'description': 'Secret key name'}, 'value': {'type': 'string', 'description': 'Secret value to encrypt and store'}, 'app_id': {'type': 'string', 'description': 'The app ID'}}}
start_owner_phone_verification
Start Owner Phone Verification
Send a 6-digit code over WhatsApp to the ACCOUNT OWNER's own phone. This is the one-time ownership proof required before a platform number can be connected, and it also unlocks agents messaging the owner. Ask the user for their own WhatsApp number first and send only to that. No WhatsApp Business account is involved.
可能执行破坏性操作 可访问外部资源
输入模式
{'type': 'object', 'required': ['phone'], 'properties': {'phone': {'type': 'string', 'description': "The owner's own WhatsApp number, ideally in E.164 form such as +972501234567."}, 'region': {'type': 'string', 'description': 'Optional ISO region hint (for example IL, US) used when the number has no country code.'}}}
update_ab_test
Update A/B Test
Update a native A/B test, including active state, variants, traffic, and conversion goal. Creates a Saved Version before the change.
可访问外部资源
输入模式
{'type': 'object', 'required': ['app_id', 'test_id'], 'properties': {'name': {'type': 'string', 'description': 'Optional new name'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'test_id': {'type': 'string', 'description': 'A/B test ID'}, 'variants': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Optional replacement variants. Traffic must total 100.'}, 'is_active': {'type': 'boolean', 'description': 'Optional active state'}, 'page_name': {'type': 'string', 'description': 'Optional new base route page'}, 'goal_event_type': {'type': 'string', 'description': 'Optional conversion goal type'}, 'goal_event_filter': {'type': 'object', 'description': 'Optional conversion goal filter'}}}
update_app
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.
输入模式
{'type': 'object', 'required': ['app_id', 'prompt'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID to update'}, 'prompt': {'type': 'string', 'description': 'What to change in the app'}}}
update_app_member_role
Update App Member Role
Update a generated-app runtime member role. This cannot assign owner and cannot change the Fine Structure account owner.
可能执行破坏性操作
输入模式
{'type': 'object', 'required': ['app_id', 'user_id', 'role'], 'properties': {'role': {'type': 'string', 'description': 'New role'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'user_id': {'type': 'string', 'description': 'Generated app user id'}}}
update_entity_metadata
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.
输入模式
{'type': 'object', 'required': ['app_id', 'entity'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'entity': {'type': 'string', 'description': 'Entity name'}, 'indexes': {'type': 'array', 'items': {'type': 'object'}, 'default': []}, 'metadata': {'type': 'object', 'default': {}}, 'relationships': {'type': 'array', 'items': {'type': 'object'}, 'default': []}}}
update_entity_record
Update Entity Record
Compatibility tool that updates one record by ID. Executes directly for the authenticated app owner.
可能执行破坏性操作
输入模式
{'type': 'object', 'required': ['app_id', 'entity', 'record_id', 'data'], 'properties': {'data': {'type': 'object', 'description': 'Fields to merge into the record'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'entity': {'type': 'string', 'description': 'Entity name'}, 'reason': {'type': 'string', 'default': '', 'description': 'Why this record should be updated'}, 'record_id': {'type': 'string', 'description': 'Record ID'}}}
update_entity_records
Update Entity Records
Update exact records. Select explicit record_ids or exact-match filters and provide shared changes, or provide per-record updates. Executes directly for the authenticated app owner; expected_count aborts the write on a mismatch.
可能执行破坏性操作
输入模式
{'type': 'object', 'required': ['app_id', 'entity'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'entity': {'type': 'string', 'description': 'Entity name'}, 'reason': {'type': 'string', 'default': '', 'description': 'Why these records should be updated'}, 'changes': {'type': 'object', 'description': 'Shared fields to merge into every selected record'}, 'filters': {'oneOf': [{'type': 'object'}, {'type': 'array', 'items': {'type': 'object'}}], 'description': 'One exact-match selector or a list of exact-match selectors'}, 'updates': {'type': 'array', 'items': {'type': 'object', 'required': ['record_id', 'changes'], 'properties': {'changes': {'type': 'object'}, 'record_id': {'type': 'string'}}}, 'description': 'Per-record changes; use instead of shared changes'}, 'record_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact record IDs to update'}, 'expected_count': {'type': 'integer', 'description': 'Required match count safety check, when known'}}}
update_entity_schema
Update Entity Schema
Replace or shallow-merge an existing entity schema file. Creates a Saved Version before writing.
输入模式
{'type': 'object', 'required': ['app_id', 'entity', 'schema'], 'properties': {'merge': {'type': 'boolean', 'default': True}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'entity': {'type': 'string', 'description': 'Entity name'}, 'schema': {'type': 'object', 'description': 'Schema fields to set or merge'}, 'indexes': {'type': 'array', 'items': {'type': 'object'}, 'default': []}, 'metadata': {'type': 'object', 'default': {}}, 'relationships': {'type': 'array', 'items': {'type': 'object'}, 'default': []}}}
update_platform_request
Update Platform Request
Platform team only: set the status of a request (open | triaged | in_progress | needs_info | deployed | wont_fix), attach the deployed commit and/or reply. deployed and needs_info mail the requester.
输入模式
{'type': 'object', 'required': ['request_id'], 'properties': {'reply': {'type': 'string'}, 'status': {'enum': ['open', 'triaged', 'in_progress', 'needs_info', 'deployed', 'wont_fix'], 'type': 'string'}, 'request_id': {'type': 'string'}, 'deployed_commit': {'type': 'string', 'description': 'Commit hash or tag that shipped it'}}}
validate_app
Validate App
Run deterministic app checks: syntax, imports, routes/pages, entity schemas, missing entities, and recorded runtime errors.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}, 'include_runtime_errors': {'type': 'boolean', 'default': True}}}
validate_change_set
Validate Change Set
Validate current app files plus staged change set files before applying.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id', 'change_set_id'], '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}}}
validate_entity_relationships
Validate Entity Relationships
Validate entity relationship metadata and *_id references against existing entity schemas.
只读 幂等
输入模式
{'type': 'object', 'required': ['app_id'], 'properties': {'app_id': {'type': 'string', 'description': 'The app ID'}}}
write_app_file
Write App File
Create or replace one file in an app's virtual filesystem. Creates a Saved Version before changing content. Paths and file model follow the Fine Structure app file API, documented at https://finestructure.ai/api/mcp/docs.
输入模式
{'type': 'object', 'required': ['app_id', 'path', 'content'], 'properties': {'path': {'type': 'string', 'description': 'Virtual file path'}, 'app_id': {'type': 'string', 'description': 'The app ID'}, 'content': {'type': 'string', 'description': 'Complete file contents'}, 'file_type': {'type': 'string', 'description': 'Optional file type override'}}}
已更改
set_entity_policy
2026年9月27日 02:51
已添加
update_platform_request
2026年9月27日 02:51
已添加
reply_platform_request
2026年9月27日 02:51
已添加
list_platform_requests
2026年9月27日 02:51
已添加
get_platform_request
2026年9月27日 02:51
已添加
create_platform_request
2026年9月27日 02:51
已添加
invoke_function
2026年9月27日 02:51
已添加
set_function_policy
2026年9月27日 02:51
已更改
get_app_security_context
2026年9月27日 02:51
已更改
get_recommended_workflow
2026年9月27日 02:51
已更改
get_platform_guide
2026年9月27日 02:51
已添加
detach_agent_whatsapp
2026年9月17日 07:56
已添加
attach_agent_whatsapp
2026年9月17日 07:56
已添加
confirm_owner_phone_verification
2026年9月17日 07:56
已添加
start_owner_phone_verification
2026年9月17日 07:56
已添加
get_agent_whatsapp
2026年9月17日 07:56
已添加
list_agent_tasks
2026年9月17日 07:56
已添加
schedule_agent_task
2026年9月17日 07:56
已添加
list_agents
2026年9月17日 07:56
已添加
create_agent
2026年9月17日 07:56
已添加
get_ab_test_stats
2026年9月17日 07:56
已添加
delete_ab_test
2026年9月17日 07:56
已添加
update_ab_test
2026年9月17日 07:56
已添加
create_ab_test
2026年9月17日 07:56
已添加
list_ab_tests
2026年9月17日 07:56
已添加
configure_integration
2026年9月17日 07:56
已添加
list_integrations
2026年9月17日 07:56
已添加
delete_secret
2026年9月17日 07:56
已添加
set_secret
2026年9月17日 07:56
已添加
list_secret_keys
2026年9月17日 07:56