tools

Create an autonomous AI agent on the user's Fine Structure account: a standing worker, not a chat session

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.

post/api/mcp/tools/create_agent

Request

  • Base URL: https://finestructure.ai
  • URL: https://finestructure.ai/api/mcp/tools/create_agent
  • Auth: HTTP bearer

Request body

namestring

Agent display name (e.g. 'Lead Follow-up'). Auto-derived from role when omitted.

rolestring required

Short role label (e.g. 'sales assistant')

descriptionstring required

What this agent is responsible for, one or two sentences

personastring

Optional working style and tone instructions for the agent

app_idstring

Optional app to attach the agent to; account-level when omitted

Response

Tool executed successfully

okboolean required
toolstring required
resultobject required

Changes

No recorded changes to this operation across all 2 revisions of this API.