MCP server

The endpoint

https://sonicweaver.com/mcp

One stateless POST, JSON-RPC over HTTP, protocol revision 2026-07-28, served by Sonic Weaver version 1.13.0. There is no account, no key and no sign-up: every tool reads catalogue content already public on this site, so an authentication step would be theatre. A GET answers 405 deliberately, because that revision removed the server-sent stream and a client opening one needs a definitive answer rather than a request that hangs.

Adding it to a client

Most clients take a block like this. The server name is yours to choose; the URL is the part that matters.

{
  "mcpServers": {
    "nss-visualizers": {
      "type": "http",
      "url": "https://sonicweaver.com/mcp"
    }
  }
}

What it exposes

Public library results include free assets, visualizer templates, Background Motion drawing and shader recipes, starter loops, tool guides, and the shared inventory of full workspaces docked in Classic and Studio. The workspace list links each tool to its guide and its editor-embedded route. Use those browser pages for private uploads, live previews, editing and local exports. MCP discovery is read-only; the browser workspace handles image analysis, audio processing, and rendering locally.

What this site can do, with live countslist_capabilities

The engines, modes and overlays this site ships right now, and the two surfaces that can run them. Every count is derived from the same registries the pages render from, so it cannot drift from what the site actually serves. Call this first when you do not yet know what is available.

Find an engine from a plain-language descriptionfind_engine

Describe the look or the track ('something calm for lo-fi', 'reacts hard to the kick', 'geometric and tunnel-like') and get the engines that fit, best first, each with the URL that opens it. Returns an empty list rather than a bad guess when nothing matches.

Read one engine's modes, controls and URLsget_engine

Everything the server holds about a single engine: its modes, the controls a person can move, which of those react to audio or can be keyframed, its performance budgets, and the URLs that open it in the Classic editor and Creator Studio. This is the handoff point: the URL is what an AI browser or a person then drives.

Build a Classic or Studio URL with the look already appliedbuild_editor_setup

Build a deep link that opens Classic (/editor) or Creator Studio (/studio) with engine, mode, frame aspect, a Sonic Weaver free song URL, overlay, intro/outro template, song title and artist toggles, a Countries & Flags country, an Animals animal, a Mythological Creatures creature, a Zodiac & Horoscopes sign, a VJ Deck's own settings (deck: its layers, master effect, clip length, strobe and driving band), a colour that follows the music (colour: in words, or colorBindingJson), optional layers (elementsJson) and optional scene actions (what the animals, people or flag do and when: sceneActions) already applied. Give a deliverable (a Spotify Canvas, a TikTok, the 16:9 music video; list_deliverables) and the setup comes back at its shape with its rules named. The visitor or an AI browser opens the URL and presses Export; this server never renders, records or exports.

The overlay librarylist_overlays

Every overlay that can be layered over a visualizer, with its category, default opacity and tags. Overlays composite in the same browser tab as the engine.

Find Sonic Weaver's built-in music, backgrounds and photosfind_assets

Search Sonic Weaver's built-in public /assets catalog: original music, sample loops, sound effects, backgrounds, photos and photo loops for videos. This is separate from the external Free Library (use find_free_media) and editable visualizer Layer Assets (use find_layer_assets). Built-in items that need credit carry their credit line. Our music, backgrounds and photos are made with generative AI and say so (aiGenerated, aiModels). Each result has its page, its file and the editors it opens in.

One built-in Sonic Weaver assetget_asset

One item from Sonic Weaver's built-in public /assets catalog by its type and id (as find_assets gives them): its file, whether it needs credit, and the editors it opens in. This does not retrieve external Free Library items or editable visualizer Layer Assets; use find_layer_assets for editable visualizer parts.

Find editable visualizer Layer Assetsfind_layer_assets

Read-only search of Sonic Weaver's public editable visualizer Layer Assets: look parts and reusable effect presets. Search by subject, name, engine, mode, role or category, including animal, sport and country variants. Results are compact metadata plus a browser link; they are not downloadable image files and this public MCP server never adds them to a private project. To add a result, open Classic or Studio and ask SW-Agent there.

Find motion graphicsfind_motion_graphics

Search the motion graphics: every look of every visualizer as a short video a person customises (colours, text, shape, length, soundtrack) and downloads from their own browser. Returns each design's page; the video is made in the browser, not by this server.

Find background visualizer templates and recipesfind_background_motion

Search public Background Motion Studio templates, drawing recipes, shader names and starter loops. Results link to editable browser workspaces and static preview files; this read-only tool cannot inspect private uploads, split images or render media.

Find tool guides and previewslist_tool_docs

List or search Sonic Weaver's public tool guides. Each result links to the tool and its guide, and names the preview type the browser page provides. Use the browser for live interaction; this read-only server does not render or export media.

Discover tools inside Classic and Studio editorslist_editor_workspaces

List the full creation workspaces currently docked in the Classic and Studio editors, with their supported capabilities, guides and direct routes. This is a public read-only index; use the browser editor for private projects, live previews, processing and exports.

Open a workspace already set upopen_workspace

Build the URL that opens one of the creation workspaces (list_editor_workspaces) with settings already applied. Workspaces with a launch contract: background-motion (template, background, mode, workflow, shape, seconds, fps); generate-visualizer (template, reference, open); motion-graphics (q, look, shape, era, sort, track, beat, title, artist, seconds); intros (card, kind, style, title, accent, duration); thumbnails (image, layout, format, title, subtitle); assistant (prompt, chain, app, ratio, width, height, base, harmony, topic, title, artist, genre, platform, count, words, kind, formula, audience, result, number, seconds, scenes, bpm, beatsPerBar, aspect, quality, note, feel, videoKbps, audioKbps, targetMb, followers, views, likes, comments, shares, saves, minutes, sections, shift, format, target, measured, peak, headline, style, industry, take, name, role, makes, place, person, structure, value, from, to, mode, first, second, date, other, amount, unit, today, colour, mood, scheme, word, key, scale, progression, source, barsPerLine, start, text, depth, bevel, background, shape, move, subtitle, accent); music-video (template, story, song, aspect, pacing, title, artist); lyrics (look, lyrics, animation, colour, size); transitions (transition, duration, direction); overlays (category, q); screensaver (starter, reference, mode, order, seconds); albums (kind, title, artist, image); assets (type, facet, q, free, sort); audio-effects (preset); templates (look, use, mood, genre, shape, aspect, q, sort, view); layers (asset); model-3d (model, material, frame, rig); mastering (preset, target, cleanup); convert (preset, format); stems (tab); watermarks (style, name, handle, accent); playlist (package, name, shape, transition); stream (station, channel, engines); image-editor (canvas); music-studio (style, bpm, key, mode, bars); video-studio (deliverable, from, cut, hits, hit, every, shot, space, rounds, at). Each setting goes through the page's own reader: one the page would not apply is refused with the reason, never written. Other workspaces open plainly. Nothing runs on the server.

Ask SW Agent what it would doask_sw_agent

Run SW Agent (Sonic Weaver's own scripted agent, v1.0.3, no AI model) on a message, read-only: it returns the function or chain it would run, the chain's steps with the data each passes on and the workspaces it uses, what it read from the message (look, frame, title, artist, country, workspace), and links that open it in a browser (SW Agent with the message ready, or the editor or workspace already set up). It also returns the checks it would make before acting (“thinking”: a contradiction, a missing file, a destination that cannot take the file, the best-practice rules that apply with their official sources, the facts it stands on, the values it would choose) and "How I would do it" in words. A help question is answered from the site's docs; a project or template request is answered from the catalogue. Nothing runs on the server: the visitor's browser runs the tools. Say which files the person has (attachments) so the plan matches.

Search Sonic Weaver's documentationsearch_help

Search every help article, FAQ answer, glossary term, tutorial, blog post, tool guide, engine page, overlay, motion graphics family and release note on the site (the BM25F index SW Agent answers help questions from). Returns up to two verbatim quotes with links to the exact section, the pages to read more, or found: false when the docs do not answer it (never a made-up answer).

Thumbnail, post, banner and profile picture sizeslist_still_formats

The picture sizes the Thumbnail maker designs and exports, grouped (video thumbnails, posts and stories, channel banners and headers, profile pictures), with each one's pixel size, file limit and safe area. The Every platform section downloads any set of them in one ZIP. Sizes marked assumed in the source came from third-party guides, not the platforms.

Transitions and video effectslist_transitions

Every transition the Classic Timeline and Studio can put between two parts of a video, and every effect it can lay over it, with what each does and its page (preview, length and direction, and downloads: a sample clip, a transparent overlay and a luma matte for other programs).

Playlist visualizer packageslist_playlist_packages

The Playlist visualizer's packages: sets of visualizer looks that go together, applied one per song across a playlist that exports as one video. Each look names its engine and mode (see get_engine), and the settings it plays with in that package when it has its own (a VJ set's clip length and strobe).

Music video maker styles and shotslist_music_video_styles

The music video maker's pre-settings: its styles (mood words, palette, pacing), pacings, frame shapes and the shelves of shot recipes it cuts a song into. The video is built in the visitor's browser on the page; this lists the choices only.

Calculate exactly, with the workingcalculate

Sonic Weaver's calculator (its own engine, no AI model): exact fractions (1/3 + 1/6 = 1/2) and units for music and video. It turns bars and beats into seconds at a tempo ("2 bars at 128 bpm in seconds" = 15/4 s), seconds into frames at a frame rate ("how many frames is 3.5 s at 30 fps" = 105), and handles ms, minutes, px, percent, degrees, radians and turns, with functions (sqrt, sin, log, clamp, lerp, noise, the Penner easings, the superformula). It returns the result, its exact form, the working and where an error is. Describe a motion instead ("pulse the scale on every kick", "loop every 2 bars") and it writes a formula for a Sonic Weaver control, checked against the control's range, its cycle and the flash limit, timed exactly from the tempo, with every fact it used and its source.

Check grammar, spelling and claritycheck_writing

Sonic Weaver's writing check (its own rules and an English dictionary from WordNet, no AI model): grammar (a or an, "could of", "their is", repeated words, capitals), punctuation and spacing, spelling with suggestions, and clarity (wordy phrases, passive voice with a doer, long sentences). Each suggestion has its exact character range, the replacements and a one-line reason; the result also gives a score out of 100, the word count, the reading time, how easily it reads (Flesch), and the text with every fix applied. Mode `lyrics` and `caption` keep the writer's own capitals and punctuation.

Recent changeslist_recent_changes

What is new on Sonic Weaver: the latest releases from the changelog, newest first, each with its date, summary and every change (added, improved or fixed). Give words to keep only the changes that mention them all, across every release. Default 3 releases, at most 10.

SW Agent benchmark scoresget_sw_agent_scores

SW Agent's benchmark scoreboard, as the status page shows it: for each skill (routing a message, reading its details, answering help, planning chains and more) the share of test messages it gets right now, its top-3 score, the floor a release must not drop below and the change since the last version, plus what SW Agent is built from (its code, tests, documents and phrasings). The tests are written apart from what it learns from, and the release gate checks they never overlap.

Run one of SW Agent's creator appsrun_creator_app

Runs one of the creator apps on SW Agent's canvas with the same function the site uses, and returns its result. Read-only: nothing is saved. Apps and their input fields: - frame-size: ratio (text up to 20 characters, optional), width (a whole number from 1 to 16384, optional), height (a whole number from 1 to 16384, optional). - colour-palette: base (text up to 7 characters, required), harmony (complementary, analogous, triad, split, monochrome; required). - caption-length: text (text up to 5000 characters, required). - hashtags: topic (text up to 200 characters, required), title (text up to 120 characters, optional), artist (text up to 120 characters, optional), genre (text up to 120 characters, optional), platform (instagram, tiktok, youtube, x, linkedin, facebook; required), count (a whole number from 1 to 60, optional). - youtube-tags: title (text up to 200 characters, optional), artist (text up to 120 characters, optional), genre (text up to 120 characters, optional), words (text up to 300 characters, optional), kind (visualizer, lyric-video, music-video, audio; optional). - hooks: topic (text up to 160 characters, required), formula (question, promise, story, contrast, list, number; required), audience (text up to 80 characters, optional), result (text up to 80 characters, optional), number (text up to 40 characters, optional), title (text up to 120 characters, optional). - reel-storyboard: seconds (a number from 5 to 600, required), scenes (a whole number from 3 to 8, optional), bpm (a number from 40 to 240, optional), beatsPerBar (a whole number from 2 to 12, optional). - type-scale: aspect (16:9, 9:16, 1:1, 4:5, 4:3, 21:9; required), ratio (minor-third, major-third, perfect-fourth, perfect-fifth, golden; required), quality (1080, 1440, 4k; optional), base (a number from 6 to 400, optional). - tempo-delay: bpm (a number from 20 to 300, required), beatsPerBar (a whole number from 1 to 12, optional), note (1/1, 1/2, 1/4, 1/8, 1/16, 1/32; optional), feel (straight, dotted, triplet; optional). - file-size: seconds (a number from 1 to 36000, required), videoKbps (a number from 0 to 200000, optional), audioKbps (a number from 0 to 1536, optional), targetMb (a number from 1 to 100000, optional). - lyric-lines: lyrics (text up to 6000 characters, required). - engagement-rate: followers (a whole number from 1 to 1000000000000, required), views (a whole number from 0 to 1000000000000, optional), likes (a whole number from 0 to 1000000000000, optional), comments (a whole number from 0 to 1000000000000, optional), shares (a whole number from 0 to 1000000000000, optional), saves (a whole number from 0 to 1000000000000, optional). - repurpose-plan: seconds (a number from 1 to 36000, required). - video-script: topic (text up to 160 characters, required), minutes (a number from 0.25 to 60, optional), sections (a whole number from 1 to 8, optional), formula (question, promise, story, contrast, list, number; optional). - caption-file: captions (text up to 50000 characters, required), shift (a number from -3600 to 3600, optional), format (srt, vtt, lrc; optional). - release-checklist: title (text up to 120 characters, optional). - loudness-target: target (streaming, apple, club, podcast, broadcast; optional), measured (a number from -70 to 0, optional), peak (a number from -30 to 6, optional). - headline-tester: headline (text up to 200 characters, required). - post-titles: topic (text up to 160 characters, required), number (a whole number from 2 to 30, optional), style (friendly, academic, useful, worker, professional, storyteller; optional). - business-names: words (text up to 120 characters, required), industry (music, tech, retail, food, finance, service, creative, wellness, media; optional), take (a whole number from 0 to 20, optional). - slogan-maker: words (text up to 120 characters, required), name (text up to 60 characters, optional), take (a whole number from 0 to 20, optional). - bio-writer: role (text up to 60 characters, required), name (text up to 60 characters, optional), makes (text up to 80 characters, optional), place (text up to 60 characters, optional), style (friendly, academic, useful, worker, professional, storyteller; optional), person (first, third; optional). - blog-outline: topic (text up to 160 characters, required), structure (short, medium, long; optional). - unit-converter: value (a number from -1000000000000000 to 1000000000000000, required), from (mm, cm, m, km, in, ft, yd, mi, nmi, mg, g, kg, t, oz, lb, st, ml, l, tsp, tbsp, floz, cup, pt, qt, gal, ukgal, ms, s, min, h, day, week, year, bit, B, KB, MB, GB, TB, KiB, MiB, GiB, TiB, cm2, m2, km2, ft2, mi2, acre, ha, mps, kph, mph, knot, hz, khz, mhz, pa, kpa, bar, psi, atm, j, kj, cal, kcal, kwh, w, kw, hp, deg, rad, turn, c, f, k; required), to (mm, cm, m, km, in, ft, yd, mi, nmi, mg, g, kg, t, oz, lb, st, ml, l, tsp, tbsp, floz, cup, pt, qt, gal, ukgal, ms, s, min, h, day, week, year, bit, B, KB, MB, GB, TB, KiB, MiB, GiB, TiB, cm2, m2, km2, ft2, mi2, acre, ha, mps, kph, mph, knot, hz, khz, mhz, pa, kpa, bar, psi, atm, j, kj, cal, kcal, kwh, w, kw, hp, deg, rad, turn, c, f, k; required). - percentages: mode (of, off, increase, decrease, tip, what-percent, change; optional), first (a number from -1000000000000 to 1000000000000, required), second (a number from -1000000000000 to 1000000000000, required). - date-calculator: mode (until, between, add, weekday, age; optional), date (text up to 60 characters, optional), other (text up to 60 characters, optional), amount (a whole number from -100000 to 100000, optional), unit (days, weeks, months, years; optional), today (text up to 10 characters, optional). - colour-converter: colour (text up to 80 characters, required), format (all, hex, rgb, hsl, oklch, lab, cmyk; optional). - lyric-writer: topic (text up to 80 characters, required), mood (hopeful, sad, happy, romantic, angry, nostalgic, hype, chill; optional), structure (verse-chorus, verse-chorus-bridge, rap-verse, hook, short; optional), scheme (aabb, abab; optional), take (a whole number from 0 to 50, optional). - rhymes: word (text up to 30 characters, required). - chord-progressions: key (C, Csharp, D, Dsharp, E, F, Fsharp, G, Gsharp, A, Asharp, B; optional), scale (major, minor; optional), progression (pop, sad, epic, jazz, lofi, blues, doowop, rock, dark, andalusian; optional). - text-insights: text (text up to 20000 characters, required). - text-case: text (text up to 2000 characters, required), to (title, sentence, upper, lower, slug, camel, snake, kebab; optional). - srt-maker: source (words, lyrics; optional), input (text up to 100000 characters, required), bpm (a number from 20 to 300, optional), barsPerLine (a number from 0.25 to 16, optional), start (a number from 0 to 36000, optional), format (srt, vtt, lrc; optional). - 3d-title: text (text up to 40 characters, required), depth (a number from 0.05 to 2, optional), bevel (a number from 0 to 0.2, optional), colour (text up to 7 characters, optional), background (text up to 7 characters, optional), shape (none, plate, ring, disc; optional), move (orbit, push-in, fly-past, still; optional). - title-card: title (text up to 80 characters, required), subtitle (text up to 120 characters, optional), style (centered, lower-third, corner, band, split, frame; optional), aspect (16:9, 9:16, 1:1, 4:5; optional), colour (text up to 7 characters, optional), background (text up to 7 characters, optional), accent (text up to 7 characters, optional). A value out of range or of the wrong kind is refused with the reason.

Every edit SW Agent can make in Classiclist_editor_commands

Lists every edit SW Agent makes in the open Classic project when asked in words: any control of the main look or a layer (set, turn up or down, reset), the layer stack (add, remove, show, hide, fade, blend, rename, reorder, select), frame rate, quality, file type, project name, play, pause, jump to a time, trim the song, mute, undo and redo. Give an engine (and a mode) to also get that look's every control with its kind, range, step, options and default. The edits run in the visitor's open editor (the SW Agent tab), never on this server.

List every site in the Novus networklist_novus_sites

The other Novus Stream Solutions sites and what each one is for. Call this when the request is not about music visualizers, so you can point at the right site instead of forcing an answer out of this one.

Every setting of every workspace, as keyslist_settings

Lists Sonic Weaver's settings as keys named workspace.setting (mastering.target, thumbnails.title, classic.bpm, look.speed): every setting of every creation workspace (from each one's own launch contract), of the open project in Classic and Studio, and every control of every look. Each comes with its kind, range or options, default, where it is by hand, how SW Agent applies it and the exact command to type into SW Agent (/set mastering.target streaming). Give a workspace for its keys, or words to find keys by name; with neither, every workspace and its count. Change one with change_setting.

Change one setting, checked exactlychange_setting

Checks one key (list_settings) and a value as SW Agent does: a number in its range on its step, one of its options (by value, label or another word: spotify is the streaming target), a colour, on or off, words, or a step such as +10 for a number. A workspace's setting comes back as the URL that opens that workspace with it applied, through the page's own reader (other settings of the same workspace can go in `settings`). A setting of the open project in Classic or Studio, or a look's control, comes back as the exact command to type into the SW Agent tab of the visitor's open editor, with that tab's address. Nothing runs on the server; a value that does not fit is refused with the key's own range or options.

Search the external Free Library for pictures, sounds, music, 3D models and booksfind_free_media

Searches the separate external Free Library: public-domain and openly licensed artworks (The Met, the Art Institute of Chicago, the Cleveland Museum of Art, the National Gallery of Art), skies, textures and 3D models (Poly Haven), sound effects and music (Kenney and OpenGameArt, served from sonicweaver.com), and books (Project Gutenberg, OpenStax). This is separate from Sonic Weaver's built-in public /assets catalog and editable visualizer Layer Assets (search those with find_layer_assets). Each item has its own licence, the credit line to carry with it, its page, and its file when it has one. Use the credit line wherever the item is used. Only compiled collections are searched, never live services.

List SW Agent's built-in scriptslist_scripts

Lists the built-in scripts of Sonic Weaver's SW Agent (its own automation, no AI model): the eight named ones (picture to project, a 9:16 lyric video, a countries batch, a playlist video, every frame shape, the release pictures, stream screens, an animal scene) and every chain as a script, each with the workspaces it runs on, the files it needs, its steps as they run (each one SW Agent function with its values, or a chain with words) and its text form. Give `workspace` (an editor workspace id, see list_editor_workspaces) to list only its scripts, or `named: true` for the eight. Read-only: scripts run in the visitor's browser on their own project, from SW Agent's page; members' own scripts are private and never listed.

List SW Agent's agentslist_agents

Lists the agents of Sonic Weaver's SW Agent (its own code, no AI model): the Visualizer, Editor, Writer, Designer, Audio, Researcher, Library, Script, Export and Planner agents, and Auto, where SW Agent (the controller) answers itself, hands a request to one agent or splits it among several and reports what each did. Each agent comes with what it is for, its rules, the kinds of tool it works with, its functions, workflows (chains, with their steps), apps and workspaces, the approvals it asks for, its limits for one job (steps, seconds, requests) and a link that opens SW Agent with a request for that agent ready to send. Give `agent` (an agent id) for one. Read-only: an agent runs in the visitor's browser, from SW Agent's chat.

Platform video files: shapes, lengths and ruleslist_deliverables

Every video file a song needs on Spotify (Canvas, Clip, Countdown video, music video), YouTube Shorts, Instagram Reels, TikTok and Apple Music motion art, from the registry Sonic Weaver's Export for uses: each one's shape, frame size it is made at and the sizes it allows, length bounds (an exclusive bound is passed by a frame), whether it must carry sound or be silent, the file types it takes, what the platform does not allow, the safe area its app's buttons and captions leave (fractions of the frame), its sources and the date they were read, and which rules to check before uploading. Export for in Classic's Timeline makes each one in the visitor's browser.

Check a video's facts against a platform's rulescheck_deliverable

Holds a video's facts against one platform file's rules (list_deliverables names them), as Sonic Weaver's Export for checks the files it makes: shape, size, length to the frame, sound present or absent, and file type. Give the numbers you read from the file; no video is sent. Returns ready or not, each failure in plain words, warnings below a recommended size, and the rules to check before uploading.

What it will not do

It cannot render, preview, record or export a visualizer. Every one of the 60 engines and 370 modes runs inside your own browser tab, on audio you chose, and nothing is uploaded, so there is no render farm for a tool to call. A tool that claimed to export a video would either have to ask for that upload or lie about the result, and keeping your audio on your device is architectural here rather than a policy.

What it returns instead is which engine exists, what it reacts to, which controls follow the audio, what it costs to run, and the URL that opens it, so the browser doing the work can be an AI browser or your own. Saved compositions, community projects and creator accounts are per-visitor and are deliberately not reachable here. See Privacy for the same guarantee stated for people, and the tool map for the whole surface at a glance.

What is counted

Each call adds one to a daily count: the tool by its name (one of the 33 above, or "unknown" for any other) or the kind of request, the family of app that called (read from the name the app gives), and whether it worked. The tool's arguments, the words of a question, the network address and any account are never kept. The counts are kept for 400 days, and when the site's Google Analytics connection is set up they are also sent there as events about the app, never about a person. Sonic Weaver is free because its pages show ads. A link to one of its pages in a tool's answer ends with utm_source=mcp, utm_medium=ai-assistant and the tool's name, so the site can see the visits its tools send; files carry no tags, and nothing about the caller is in them. That is the person's choice: every tool takes plainLinks, and plainLinks: true answers with plain links and nothing else changed. Each tool's own description of plainLinks, and the server's instructions, tell the assistant this before it sends anyone. See Privacy.