---
title: "Return the recommended MCP tool sequence for a task type"
method: POST
path: "/api/mcp/tools/get_recommended_workflow"
tags: ["tools"]
---

# Return the recommended MCP tool sequence for a task type

`POST /api/mcp/tools/get_recommended_workflow`

## Request

- Base URL: `https://finestructure.ai`
- URL: `https://finestructure.ai/api/mcp/tools/get_recommended_workflow`
- Auth: HTTP bearer

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.

## Request body

- object
  - `task_type` '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': The task type to plan.
  - `goal` string: Optional short description of the user's goal.
  - `app_id` string: Optional app ID. If provided, the workflow includes a safe app context summary.

## Response `200`

Tool executed successfully

- ToolResult
  - `ok` boolean, required
  - `tool` string, required
  - `result` object, required

## Other responses

- `400`: Invalid arguments for this tool
- `401`: Missing or invalid bearer token
- `402`: Not enough credits on the account
- `403`: Token scope does not permit this tool
- `404`: Unknown tool name
- `429`: Rate limit exceeded, retry after the indicated delay
- `500`: Internal error while executing the tool

---

[API](https://skmtc.dev/finestructure/apis/fine-structure-api.md) · [All operations](https://skmtc.dev/finestructure/apis/fine-structure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finestructure/apis/fine-structure-api/revisions/02c50ed5fd70?raw)