Know what ShapelessAI can do
Read everything an account can do as one JSON list before holding a key: each capability with its REST operations, MCP tools, CLI lines and page, and every planned one with how to get the same outcome today, the route it will answer at and how many are waiting on it.
A planned route already exists and answers 501; ask to be told and the account's email, or the email or webhook given, hears the day it ships.
Ask in plain words
- "what can ShapelessAI do from the API"
- "tell me when the trends API ships"
- "is there an endpoint for rendering a scripted video"
From an agent host (MCP)
Server: https://shapelessai.com/mcp (add it to your host).
capabilities_list: Everything ShapelessAI can do, live or planned, with the REST routes, MCP tools and CLI lines for each and its page. A planned one says how to get the same outcome today and carries a want door; one with a route answers 501 there until it ships. Needs the read scope (over REST it needs no key).capabilities_want: Ask to be told the day a planned capability ships. Bound to this account's sign-in email; add an email or https webhookUrl to tell somewhere else. Ask the human first. Needs the read scope.
From code (REST)
Bearer API key with the scope each call names (auth, OpenAPI).
GET /api/capabilities(no key): Everything ShapelessAI can do, live or planned, with the route, CLI verb and MCP tool for each. A planned one carries its want door and how many wait on it.POST /api/capabilities/{id}/want(no key): Tell me when this ships. A bearer key of any scope binds it to the account (told at its sign-in email); otherwise send {email} or {webhookUrl}. A live capability answers 200 with its routes.
The body
POST /api/capabilities/{id}/want:
emailstring: Where to say it shipped; unneeded with a bearer key.webhookUrlstring: https URL that gets a POST {event: capability.live, capability, routes, docs}.notestring: What you wanted it for. We read these.
From a terminal (CLI)
shapeless capabilities
Example
Refusals
| Status | Meaning |
|---|---|
| 400 | No key, email or webhook to tell. |
| 404 | No such capability. |
| 429 | Too many asks. |
More in The agent team
Hand over a goal · Run standing agents · Run the manager · Cast actors and voices
