Call any agent tool

GET /api/tools lists each with its JSON Schema input and price, no key needed. A call holds credit for its budget (default $2, at most $10) and settles at what it really cost.

Ask in plain words#

• "which tools can my agent call on Shapeless"
• "search X for what people say about our launch"
• "find licensed stock footage of hands on a keyboard"
• "screenshot our homepage for a post"

From an agent host (MCP)#

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

• tools_list: Every tool the Shapeless studio agent holds, callable on its own: generate_image, generate_footage (AI video), edit_footage (edit an uploaded video), render_carousel, render_thumbnail, demo_page, web_search, x_pulse, news_search, find_photo, find_footage, probe_media and more - each with its JSON Schema input and default price. Needs the read scope.
• tools_run: Run one tool from tools_list with its input; SPENDS CREDIT (budgetUsd default 2, max 10). Answers the tool's output plus a URL for every file it made; put a media key on posts_create to publish it. Needs the write scope.

From code (REST)#

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

• GET /api/tools (no key): Every agent tool this deployment serves on its own: name, description, JSON Schema input, default price. The same tools the studio agent holds.
• POST /api/tools/{name} (write scope): Run one tool: the body is its input (schema on GET /api/tools) plus optional budgetUsd (default 2, max 10). Answers {tool, output, media[{key, url}], chargedUsd}.

From a terminal (CLI)#

• shapeless tools

Example#

curl -s https://shapelessai.com/api/tools/x_pulse -H "Authorization: Bearer $SHAPELESS_API_KEY" -H "Content-Type: application/json" -d '{"query":"shapeless ai"}'

// MCP tool call
{ "tool": "tools_run", "arguments": { "name": "x_pulse", "input": { "query": "shapeless ai" } } }

shapeless tools run x_pulse --input '{"query":"shapeless ai"}'

Refusals#

Where else#

• The api docs (markdown)