Call any agent tool
Every tool our studio agent holds, called on its own with the same code the agent runs: search the web, read X, news and community pulse, find evidence, stock photos and licensed footage, brand marks, page screenshots and recordings, media probes, music beds, plus every media tool above.
Each is its own MCP tool under the same name, and 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 ShapelessAI"
- "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: The live catalog of the ShapelessAI studio agent's tools, each with its JSON Schema input and default price. Every one is also its own MCP tool here (generate_image, generate_footage, edit_footage, render_carousel, web_search, x_pulse and the rest); this is the read for what the deployment serves right now. Needs the read scope.clone_reel: Remake a reel at a URL with the account owner in the presenter's place: same cuts, shots, timing and captions. With recording_media_key (their own take of measure_reel's script) their footage and voice go in, compute only. Takes 10 to 60 minutes; only_segment is the cheap probe. Returns a media key. Only for a reel the user asked to copy, with their own face and voice. SPENDS CREDIT: about $0.32 of engine cost a default call, billed with the plan's margin; budgetUsd caps it (default 2, max 10) and chargedUsd says what it cost. Needs the write scope.plan_music: Generate an instrumental music bed from a style (genre, mood, instruments, tempo; never an artist) and get its media key with its beat grid (bpm, beat times), so a video can be cut on the beat. Pass the key as edit_footage's music. SPENDS CREDIT: about $0.06 of engine cost a default call, billed with the plan's margin; budgetUsd caps it (default 2, max 10) and chargedUsd says what it cost. Needs the write scope.write_song: Sing lyrics you wrote ([Verse] and [Chorus] marked) in a style you describe (genre, mood, tempo, voice; never a real artist) as an original one to three minute MP3 in the media library. Returns its media key and the lyrics as sung. For a bed under narration use plan_music. SPENDS CREDIT: about $0.08 of engine cost a default call, billed with the plan's margin; budgetUsd caps it (default 2, max 10) and chargedUsd says what it cost. Needs the write scope.probe_media: Look at a video or audio file in the media library: duration, size, frame rate, loudness, a filmstrip of timestamped frames, frames at chosen seconds, the waveform, and for speech every word with its time and the same words as numbered beats. Read it before edit_footage. Free: nothing is charged. Needs the write scope.measure_reel: Measure a reel at a URL the way an editor would: every cut and shot, every spoken word with its time, burned-in captions and on-screen text, the music actually heard, loudness and pacing, plus the spoken words as a teleprompter script. Takes 2 to 6 minutes. Read it before clone_reel, or to make a reel like it. SPENDS CREDIT: about $0.053 of engine cost a default call, billed with the plan's margin; budgetUsd caps it (default 2, max 10) and chargedUsd says what it cost. Needs the write scope.find_photo: Fetch one licensed real photograph (stock or Pixabay) or a blank meme template into the media library as a media key. Every result carries its licence; credit it when attributionRequired is true. Free: nothing is charged. Needs the write scope.find_footage: Fetch one licensed real video clip (stock, Pixabay, the Internet Archive, NASA, Wikimedia Commons, reaction GIFs) into the media library as a media key. Search in two to four concrete words. B-roll only: no recognizable faces, logos or branded property. Free: nothing is charged. Needs the write scope.find_face: Fetch a real photograph of a named person into the media library: their freely licensed Wikipedia portrait first, else the photo they publish themselves. Pass about (company or role) so a common name lands on the right person. Static use only; credit it when attributionRequired is true. Costs a fraction of a cent (about $0.007) from credit; budgetUsd (default 2, max 10) caps it and chargedUsd says what it cost. Needs the write scope.brand_mark: A company's or product's real logo, ready to place: pass the brand name, and its domain when known. Returns the brand:<slug> handle, which colour cuts exist and a PNG media key. Small brands are looked up on the web. Costs a fraction of a cent (about $0.007) from credit; budgetUsd (default 2, max 10) caps it and chargedUsd says what it cost. Needs the write scope.web_search: Search the web for current facts, stats or trends. Returns hits (title, url, snippet) and, when available, a synthesized answer grounded in them. SPENDS CREDIT: about $0.015 of engine cost a default call, billed with the plan's margin; budgetUsd caps it (default 2, max 10) and chargedUsd says what it cost. Needs the write scope.read_page: The full clean text of a URL, from a cached copy when the live page blocks robots. Costs a fraction of a cent (about $0.006) from credit; budgetUsd (default 2, max 10) caps it and chargedUsd says what it cost. Needs the write scope.screenshot_page: A real browser renders a URL (JavaScript runs, fonts load) and returns the picture as a media key: the viewport, the full page, or one element by CSS selector, on a phone or laptop viewport. Free: nothing is charged. Needs the write scope.record_page: A real browser opens a URL and scrolls it smoothly top to bottom; returns an MP4 media key plus its first frame. 8 to 15 seconds reads as one shot. Free: nothing is charged. Needs the write scope.capture_tweet: Draw a public x.com post the way X shows it (avatar, name, text, media still, date, counts) as a 1080px-wide PNG media key, dark or light, optionally under the post it replies to. Free: nothing is charged. Needs the write scope.list_page_assets: The media a page renders (images, videos, logos, the social preview card), largest first, with real pixel sizes and what each is for. fetch_asset the one you want. Free: nothing is charged. Needs the write scope.inspect_page_style: A page's visual identity as design tokens: heading and body typefaces, the palette by role as hex, the button radius and its logo, measured as a visitor sees it. Free: nothing is charged. Needs the write scope.fetch_asset: Pull an image, video, audio file or PDF at a public URL into the media library as a media key. A fetched file is reference material until you know you may republish it. Free: nothing is charged. Needs the write scope.site_index: Everything a site publishes, counted from its own robots.txt and sitemaps: pages by type (blog, tool, compare, docs, pricing, landing), the biggest sections, the newest update, and where it speaks to agents (llms.txt, MCP, OpenAPI, API docs, a skill file). Free. Free: nothing is charged. Needs the write scope.seo_profile: A domain's search and AI-answer footprint from the Ahrefs index: Domain Rating, referring domains, estimated organic traffic, keywords and traffic value, and how many AI-assistant answers cite it. depth "full" adds top pages, keywords, organic competitors and 6 months of traffic; compareTo puts your own domain beside it with the keyword gap. One domain is bought once a day. SPENDS CREDIT: about $0.081 of engine cost a default call, billed with the plan's margin; budgetUsd caps it (default 2, max 10) and chargedUsd says what it cost. Needs the write scope.measure_text: Count copy so a number beside a draft is measured, never typed: up to 20 texts, public page URLs or numbers another tool returned, in one call. Every item marked ours (the current one and each option) is held against the same reference median. Per measure: median, quartiles and count, yes/no measures as "7 of 10", a price on different billing bases never pooled. Words, sentences, reading grade, hook words, numbers, you against we; a page adds its hero, its first screen with the nav counted apart (words, buttons, calls to action, logos, the largest picture), the phone's first screen, and any redirect. Returns a row each, ours as a multiple of the median, and a compare table ready to show. Free. Free: nothing is charged. Needs the write scope.read_repo: An open GitHub repository read through its API, never cloned: stars, forks, issues, the licence and whether it permits commercial use, stars per month and in the last 30 days, releases and contributors. depth "tree" adds two levels with tests, CI and every licence file, from the root or any folder; find searches every path by glob or name; depth "file" reads one file, as untrusted data. Says how much of GitHub's hourly allowance is left. Cached for the day. Free. Free: nothing is charged. Needs the write scope.product_hunt: A product launch as Product Hunt counts it: votes, comments, review rating and review count, and the day it was featured. Give the launch slug or its producthunt.com URL. Free. Free: nothing is charged. Needs the write scope.company_measures: What Shapeless already holds on 1 to 12 companies (domains or organization ids), side by side: each measured number with its date, source and rigor, the words held (hero line, the play), sources that disagree, and per company which facets (search, ai, site, product, pricing, reputation, social, ads, money, company) are lit, stale or dark, with the tool that fills each. Free; call it before any paid measurement. Free: nothing is charged. Needs the write scope.company_pages: A company's pages as Shapeless holds them (sitemap, crawl, pages that earn search traffic): the count by page type with summed traffic, its page templates, and the pages, most traffic first. Filter by type, template or a word in the URL or title. Free. Free: nothing is charged. Needs the write scope.company_keywords: The search keywords and AI-assistant prompts a company is seen on, most traffic first, with position and volume; missingFrom another company returns only the gap. Free. Free: nothing is charged. Needs the write scope.market_rank: Every company Shapeless holds a number for, ranked on one metric (organic_traffic, github_stars, mrr_usd, ...), filtered by their other measures, with growthSince for the change and percent since a date. Free. Free: nothing is charged. Needs the write scope.company_note_measures: Store up to 40 measures you read yourself about a company (a hero line, a price, a star count, the play you concluded), dated today and kept for this account only, so the next look starts from them. Metric ids are the ones company_measures names. Free. Free: nothing is charged. Needs the write scope.x_pulse: An agent searches X live and answers what practitioners are saying about a topic right now, with per-claim citations and engagement evidence. Use it to learn what people say; to learn how much they say it, use current_pulse. Slow (about 60 seconds) and the dearest search: ask one sharp question. SPENDS CREDIT: about $0.25 of engine cost a default call, billed with the plan's margin; budgetUsd caps it (default 2, max 10) and chargedUsd says what it cost. Needs the write scope.company_changes: What changed on a company's own pages (home, pricing, changelog, features) between two days, or across every company in a field: the day it was seen, the headline and prices before and after, lines added and removed, the diff, and any why already noted. Pages are compared from their second weekly read on. Free. Free: nothing is charged. Needs the write scope.company_page_at: A company's page as Shapeless stored it on or before a day: its text, headline, title and prices, with the list of reads around it. Give a URL or a role (home, pricing, changelog, features, about). Never reads the live page. Free. Free: nothing is charged. Needs the write scope.company_note_change: Store why a company changed a page (a launch, a price test, an acquisition) with the URLs that show it, against a change company_changes listed. Kept for this account only. Free. Free: nothing is charged. Needs the write scope.market_companies: Every company Shapeless files in a field (competitive intelligence, social data APIs, ad intelligence, ...), with its sub-field, search traffic, domain rating, lowest price, MCP and the newest day it was read; without a field, the list of fields and how many companies each holds. Free. Free: nothing is charged. Needs the write scope.news_search: Fresh, dated journalism on a query from a curated news index, press-release wires filtered out. within_days narrows the window. SPENDS CREDIT: about $0.01 of engine cost a default call, billed with the plan's margin; budgetUsd caps it (default 2, max 10) and chargedUsd says what it cost. Needs the write scope.concept_search: Semantic search for pages and LinkedIn or X posts that mean what you describe rather than match its words: describe a persona saying or feeling something and get real, dated posts and articles. Costs a fraction of a cent (about $0.007) from credit; budgetUsd (default 2, max 10) caps it and chargedUsd says what it cost. Needs the write scope.community_hot: The live top of Hacker News or of a subreddit's hot ranking, with scores. Free: nothing is charged. Needs the write scope.current_pulse: How much X is talking about 1 to 6 short phrases right now: 7-day volume, per-day counts, velocity and sample posts for the loudest, with a wave flag when one is big. Counts only, in seconds; to learn what people are saying, use x_pulse. SPENDS CREDIT: about $0.06 of engine cost a default call, billed with the plan's margin; budgetUsd caps it (default 2, max 10) and chargedUsd says what it cost. Needs the write scope.related_trends: Up to 3 current trends (news, Hacker News, X, refreshed daily) related in meaning to a topic, each with a one-line summary and how current it is. Verify one with web_search before writing on it. Costs a fraction of a cent (about $0.00001) from credit; budgetUsd (default 2, max 10) caps it and chargedUsd says what it cost. Needs the write scope.find_evidence: Semantic search over 322M scholarly works: a claim or topic in, works out with title, year, citation count, venue, url and abstract. Cite only what the abstract supports. Costs a fraction of a cent (about $0.001) from credit; budgetUsd (default 2, max 10) caps it and chargedUsd says what it cost. Needs the write scope.reference_search: Search our judged library of real posts and videos that already performed: give the intent (topic and angle) and get a ranked shortlist with numbers, hook and format. Read the ones you want with reference_read. Costs a fraction of a cent (about $0.00001) from credit; budgetUsd (default 2, max 10) caps it and chargedUsd says what it cost. Needs the write scope.reference_read: Read 1 to 3 exemplars from reference_search in full: why they worked, their structure and beats, the transcript and on-screen text, and the recipe to rebuild the format for another brand. Free: nothing is charged. Needs the write scope.linkedin_org_lookup: The verified LinkedIn mention token for a large company, or the companies for a topic, like @Microsoft, ready to paste into a LinkedIn post. Tag only a company it returns. Free: nothing is charged. 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}.
The body
POST /api/tools/{name}:
budgetUsdnumber: The most this call may spend, in USD (default 2, max 10). Held while the tool runs, released after.
From a terminal (CLI)
shapeless tools
Example
Refusals
| Status | Meaning |
|---|---|
| 400 | The input does not match the tool's schema; the message names the field. |
| 402 | Not enough credit to hold budgetUsd, or the call costs more than budgetUsd. |
| 404 | No such tool on this deployment. |
| 422 | The tool refused this input; nothing was charged. |
| 502 | The tool failed; nothing was charged. |
Where else
More in Media
Generate an image · Generate AI video · Edit a video · Record a product demo · Render a carousel · Render a thumbnail · Turn text into speech · Make subtitle files
