AnimatedWebs

Writes one new UI component from a text description with AnimatedWebs AI and returns a complete self-contained HTML document (Tailwind CDN, inline JS). Use it when no library component fits; search_catalog (kind components) first to reuse one, and refine_component to change a result. The text block is the HTML preceded by an HTML comment naming the model and the generations left; structuredContent has html, model and generationsLeftToday. Each successful call uses one daily generation (Free 5, Pro 100 per UTC day, shared with refine_component and the tools site); a call where no model ran is not counted. Not idempotent: each call gives different output. If the generator is busy it returns an error; retry after a minute. Example: {"prompt":"a pricing section with three plans and a yearly toggle","style":"glass"}.

Returns the signed-in account's AnimatedWebs plan and today's usage (Pro prompt access or Prompt Pack credits, UI generations and Design AI requests used against the daily limits), links, the Design workspace URL, and on request the account's items. Use it to check whether a Pro prompt, generate_component or refine_component call will succeed, or to pick up earlier work; use get_pricing for plan prices and save_item to change saved items. include_items adds items: saved (templates, components and backgrounds saved with save_item or hearted on animatedwebs.com), unlocked (Pro templates already opened, so fetching their prompt again is free) and generated (prompt, model and date of each AI generation; the HTML itself is not stored). includeDesignConnect adds ready-to-paste setup for the separate AnimatedWebs Design MCP server; it contains a personal bearer token, so never write it to shared files. Counts are per UTC day. Read-only. Example: {"include_items":true,"items":"saved","items_limit":10}.

Returns one AnimatedWebs cinematic video background by slug: on Pro and Lifetime the clean watermark-free MP4 URL plus an HTML snippet for a muted, looping, autoplaying hero video; on other plans the watermarked preview URL, clean: null and the plan required (not an error). Use it after search_catalog (kind backgrounds); use get_template for full website templates. A clean file counts toward the fair-use cap shared with get_component source (40 per 10 minutes, 150 a day, 500 a week; never blocks one already opened today). Read-only. Unknown slugs return an error. Example: {"slug":"aurora-loop"}.

Returns one AnimatedWebs UI library component by id: description, runtime, interaction, tags, every variant with live URL and thumbnail, import name, shadcn install command, and with include_source true its complete source code (Pro). Use it after search_catalog (kind components) to inspect a component and then add it to a project; use generate_component instead when nothing in the library fits. Details never spend a credit. include_source needs AnimatedWebs Pro (others get an error with the pricing link) and returns code: the renderer and shared files with a per-account watermark, filling about 120,000 characters; files that did not fit have no code and are named in code.omitted, so call again with that path to get one file. New components count toward a fair-use cap (40 per 10 minutes, 150 a day, 500 a week, shared with get_background) that never blocks one already opened today. Unknown ids return an error. Example: {"id":"aurora-hero","include_source":true}.

Returns one verified AnimatedWebs creator's public profile by handle (name, headline, bio, website, stack, specialties, tier, certificate number, profile URL) and their live templates (title, tagline, kind, access, price in USD, stack, demo and preview URLs). Use it after search_catalog (kind creators); for catalog templates use get_template. Never includes prompts. Read-only. Unknown or unverified handles return an error. Example: {"handle":"ada"}.

Returns AnimatedWebs plans and prices (Free, Prompt Pack, Pro monthly and yearly, Lifetime) with what each includes, founding Lifetime spots left and the pricing page URL. Use it for plan and price questions; use get_account for the signed-in user's own plan, credits and usage. Prices are numbers in USD; only the founding or the regular Lifetime plan is listed, depending on spots left. No parameters. Read-only. Example: {}.

Returns the full DESIGN.md for one AnimatedWebs website style reference (colour tokens, type scale, radius, buttons, layout notes, build prompt) plus a Tailwind v4 @theme block and CSS variables. Use it after search_catalog (kind styles) to build original work in that style; use get_template for a ready AnimatedWebs template. It is guidance only: do not copy the source site's logo, images, copy or trademarks. No credits, no pagination. Read-only. Unknown slugs return an error. Example: {"slug":"stripe"}.

Returns one AnimatedWebs template by slug: description, stack, tags, access level, tools it works with, licence note, demo and preview URLs, views, saves and likes, and with include_prompt true the full build prompt as Markdown. Use it to inspect a template found with search_catalog and, once the user has chosen, to get the prompt and build it in the current project; use open_builder instead to hand the prompt to Lovable, v0 or Bolt. Without include_prompt it never spends a credit and changes nothing. With include_prompt: free templates work on any signed-in account; a Pro template is included with Pro and Lifetime, otherwise the first fetch spends one Prompt Pack credit (later fetches of that slug are free) and an account with no credits gets an error with the pack link. New Pro prompts have a fair-use cap (20 per 10 minutes, 60 a day, 200 a week, shared with open_builder) that never blocks a prompt already opened today. Free-plan accounts may get a short upgrade note as a second text block. Unknown slugs return an error. Example: {"slug":"aurora-site","include_prompt":true}.

Lists the valid values for search_catalog's category filter, with counts. Use it before filtering a search by category; use search_catalog itself to find items. kind templates (default) returns AnimatedWebs template categories under categories (fixed display order, zero-count categories included, some with a description) and the template kinds website, section and background under kinds; kind components returns UI library categories with component and variant counts under componentCategories (only non-empty ones); kind all returns both. Backgrounds, styles and creators have no categories. No pagination. Read-only. Example: {"kind":"components"}.

Lists, checks or cancels the signed-in account's own template requests (sent with request_template or the contact form's template-request topic). Use it to follow up on a request instead of sending it again; use request_template to send a new one. action list (default) returns recent requests newest first; action status returns one request by id; action cancel withdraws one request by id, which only works while it is still received (not yet reviewed) and marks it cancelled so the team skips it. Each request has id, createdAt, the first 200 characters and status (received, reviewed or cancelled). Only the account's own requests are visible or cancellable: another account's id answers as not found. list and status change nothing; cancel cannot be undone (send a new request instead). Examples: {"action":"list","limit":5}, {"action":"cancel","id":42}.

Returns links that start a new project from one AnimatedWebs template's build prompt in Lovable, v0 and Bolt; nothing is created until the user opens a link. Use it to hand a template to a hosted AI builder; use get_template with include_prompt true instead to build it yourself in the current project. Same access rule and fair-use cap as get_template with include_prompt: free templates need any signed-in account; a Pro template is included with Pro and Lifetime or spends one Prompt Pack credit on first use (later calls are free). The prompt is embedded in each link, so v0 and Bolt links are left out when longer than 7,000 characters; lovable is always present. Unknown slugs return an error. Example: {"slug":"aurora-site"}.

Applies one requested change to an existing component's HTML with AnimatedWebs AI and returns the complete updated HTML document. Use it to iterate on a generate_component result (or any self-contained HTML component); use generate_component to start from scratch. Output has the same shape as generate_component (HTML text block with a model comment; structuredContent html, model, generationsLeftToday). Uses one daily generation from the same shared allowance (Free 5, Pro 100 per UTC day); a call where no model ran is not counted. Not idempotent. If the generator is busy it returns an error; retry after a minute. Example: {"html":"<!doctype html>...","change":"make the cards glass and add a hover tilt","style":"glass"}.

Sends the AnimatedWebs team a request for a new template or component that the catalog does not have, and returns the request id. Use it only after search_catalog found nothing suitable; use manage_request to check, list or cancel requests already sent instead of sending one again. It writes one message to the team's inbox tied to the signed-in account; every call creates a new request, so repeating it makes a duplicate. Requests are reviewed for the weekly template drops and Lifetime members are prioritized. Example: {"request":"a scroll-driven hero for a yacht charter in Miami with a night-sea video"}.

Saves, unsaves or lists the signed-in account's favorite AnimatedWebs templates, UI components and cinematic backgrounds. Use it when the user wants to keep an item for later or see what they kept; use get_account with include_items for the full picture (saved plus unlocked and generated items). action save adds the item (saving twice is a no-op), unsave removes only the bookmark (removing an unsaved item is a no-op, and it can be saved again), list returns saved items newest first, optionally only one type. Saved templates are the same list as the Save heart on animatedwebs.com and the dashboard. The id must exist in the catalog. Examples: {"action":"save","type":"template","id":"aurora-site"}, {"action":"list","type":"component"}.

Searches the AnimatedWebs catalog (AnimatedWebs templates, UI library components, cinematic video backgrounds, website style references and verified creators) and returns metadata grouped by kind, never prompt text or source code. Use it first to find an identifier, then open one item with get_template, get_component, get_background, get_style_reference or get_creator; use list_categories for valid category values. An empty query browses a family in catalog order. Template and component queries match each word as a case-insensitive substring and rank by words matched (ties keep catalog order); background, style and creator queries match the whole text as one substring. Filters apply per kind (templates: category, access, templateKind, technique; components: category, runtime). With kind all a family that cannot use a supplied filter is skipped; with one kind an unusable filter is an error. Paging: each group has nextCursor (null on the last page); pass it back as cursor with the same kind, query and filters. Template results include views, saves and likes. Read-only. Example: {"query":"particles hero","kind":"templates","technique":"particles","limit":5}.