# Fine Structure Tools API

**Canonical:** https://apis.io/apis/finestructure-ai/finestructure-ai-tools-api/  
**Provider:** Fine Structure — https://apis.io/providers/finestructure-ai/  
**Base URL:** https://finestructure.ai  
**Documentation:** https://finestructure.ai/docs

Fine Structure Tools API is one of 4 APIs that [Fine Structure](https://apis.io/providers/finestructure-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 5 JSON Schema definitions. Tagged areas include Tools. The published artifact set on APIs.io includes an OpenAPI specification and 5 JSON Schemas.

Per-tool REST operations (one per Fine Structure tool)

## Operations (60 of 368)

| Method | Path | Summary |
|---|---|---|
| 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… |
| 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_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… |
| 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… |
| 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… |
| 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… |
| 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 \|… |

…and 308 more operations. The page lists the first 250; the full set of 368 is in the OpenAPI linked below.

## Machine-readable artifacts (6)

- **OpenAPI** — https://artifacts.apis.io/finestructure-ai/openapi/finestructure-ai-tools-api-openapi.yml
- **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

## Other Fine Structure APIs (3)

- [Fine Structure Bridge API](https://apis.io/apis/finestructure-ai/finestructure-ai-bridge-api/)
- [Fine Structure Discovery API](https://apis.io/apis/finestructure-ai/finestructure-ai-discovery-api/)
- [Fine Structure MCP API](https://apis.io/apis/finestructure-ai/finestructure-ai-mcp-api/)

## Tags

Tools

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/finestructure-ai/finestructure-ai-tools-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/finestructure-ai/.