Run standing agents

An agent proposes into the queue on its cadence; give it autoPublishPosts and it publishes without a human, which is why that flag costs the publish scope. One call asks the engine to suggest an agent seed from what it has studied about the account.

Ask in plain words#

• "set up an agent that proposes one Reddit post every Monday"
• "pause the daily LinkedIn agent"
• "wake the launch agent now"
• "suggest an agent for my account"
• "have an agent publish a daily X take without asking me"

From an agent host (MCP)#

Server: https://shapelessai.com/mcp (add it to your host).

• agents_list: The agent roster (the API calls them strategies). Needs the read scope.
• agents_save: Create an agent (no id) or edit one (with id). Setting autoPublishPosts arms publishing without human approval and needs the publish scope; everything else needs write.
• agents_wake: PUBLISH-SCOPED: wake an agent now; it plans and proposes (or with auto-publish, posts) immediately. Returns the conversation it woke into and its web url. Needs the publish scope.

From code (REST)#

Bearer API key with the scope each call names (auth, OpenAPI).

• GET /api/strategies (read scope): The agent roster.
• POST /api/strategies (write scope): Create an agent (publish scope when autoPublishPosts).
• PATCH /api/strategies/{id} (write scope): Edit an agent (publish scope when autoPublishPosts).
• POST /api/strategies/{id}/run (publish scope): Wake an agent now.
• POST /api/strategies/suggest (write scope): One engine-studied agent seed for the editor.

From a terminal (CLI)#

• shapeless agents list
• shapeless agents show
• shapeless agents create
• shapeless agents edit
• shapeless agents pause
• shapeless agents resume
• shapeless agents wake

Example#

curl -s https://shapelessai.com/api/strategies -H "Authorization: Bearer $SHAPELESS_API_KEY" -H "Content-Type: application/json" -d '{"name":"Monday on r/SaaS","prompt":"One honest post a week about what we learned shipping.","planDays":[1],"planHours":[9],"timezone":"Europe/Berlin"}'

// MCP tool call
{ "tool": "agents_wake", "arguments": { "id": "<agentId>" } }

shapeless agents wake <id>

Where else#

• Do it in the studio