---
title: "Open a request to the Fine Structure platform team: a bug, a feature request or a question about the platform itself ..."
method: POST
path: "/api/mcp/tools/create_platform_request"
tags: ["tools"]
---

# 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/create_platform_request`

## Request

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

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.

## Request body

- object
  - `type` 'bug' | 'feature' | 'question', required
  - `title` string, required: One line, what is wrong or missing
  - `body` string, required: Free text, markdown allowed: context, impact, what you tried
  - `app_id` string: Optional: the app where it showed up
  - `severity` 'blocker' | 'high' | 'normal' | 'low'
  - `reproduction` string: Steps, invoke_function calls or curl commands that reproduce it
  - `expected` string: What should have happened
  - `acceptance` string: How the team will know it is closed
  - `attachments` string[]: Optional app file paths or log ids

## 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)