Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
MCP Tools Catalog
three.ws ships several MCP servers: tool servers that AI assistants (Claude, ChatGPT, any MCP client) can call directly. One is free and 3D-only; the others expose paid tools that settle per call in USDC over x402. This page explains how the servers are grouped and how the paid ones charge.
Looking for a specific tool? The complete, always-current list lives at /mcp-tools: every tool on every server, searchable, with its price and whether an AI client can run it unattended. That page is generated from the source of each tool on every build, so it cannot drift. The same data is machine-readable at
/mcp-catalog.json.The tables below are a curated orientation to the servers, not the full index. Where a figure here and the catalog disagree, the catalog is right.
The catalog on a phone. Search, filters and the per-tool detail all work at 320px, so you can look a tool up from anywhere.
Source:
api/mcp-studio.js(free),api/mcp-3d.js+api/_mcp3d/pricing.js(paid studio),api/_mcp*/+packages/*-mcp(agent/commerce tools).
How the totals are calculated
The totals are computed, never typed. At build time npm run build:mcp-catalog imports the exact catalog each hosted endpoint serves, and loads every stdio package in-process and asks it for tools/list, resources/list and prompts/list over an in-memory MCP transport. The result is /tools.json and /mcp-catalog.json, currently 709 tools (603 unique names) on 51 servers. At request time /api/mcp-census recounts the hosted endpoints from the running code and reports whether they still match the build.
- tools: every tool a server can serve, including financial-tier tools the policy hides until a session enables them.
- resources, templates, prompts: the matching
*/listentries, prompts rendered against that server's own catalog. - unique: distinct tool names.
/api/mcp-chatgptand/api/mcp-grokserve subsets of/api/mcp-studio, so per-server figures overlap.
Every tool declares all four annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) and a description with a "Use this when..." line; tests/mcp-tool-quality.test.js fails otherwise, and tests/mcp-prompt-references.test.js fails when a prompt names a tool, resource or prompt that does not exist. Run both with npm run test:mcp-surface.
Quoting a count in a doc. Wrap it in a marker: <!-- mcp-count:mcp-3d.tools -->40<!-- /mcp-count -->. The key is <scope>.<field>: scope is all, hosted, stdio or a server id from /tools.json; field is servers, tools, uniqueTools, resources, templates, prompts, free or paid. npm run check:mcp-counts (part of npm run gate) fails on a marker that disagrees with the census and on an unmarked "N tools" in a living doc that is about a server; npm run check:mcp-counts -- --fix rewrites marker values. Add <!-- mcp-count-ignore --> to a line whose number is not about a three.ws server.
Per-tool pages and releases
Every tool has a page at /mcp-tools/<server>/<tool> with its schema, an example call (curl, JSON-RPC body, client config), its price and hints. Free, read-only tools served over HTTP have a try-it form that calls the live endpoint. /mcp-tools#releases shows which tools each release added, built from git history into /mcp-tool-history.json.
How paid MCP tools charge
The paid servers follow the MCP v2 transport convention: a tools/call made
without an x402 payment payload in _meta returns a PaymentRequired
structuredContent that quotes the price and the accepted networks. The client
settles the USDC payment (Solana or Base) and retries the call with the payment in
_meta. Generation tools quote by quality tier so the 402 quote, the verified
payment, and the settled charge all match the work requested.
A few tools are free (no payment, wallet, or key) — notably forge_free and
the read-only studio helpers below.
Free 3D Studio — /api/mcp-studio
A free, non-crypto MCP server for the ChatGPT App Directory and any MCP client. It exposes only 3D generation/inspection — no account, no payment, no token. See 3D Studio MCP.
Material Studio (hosted, free) — /api/material-studio
A free, rate-limited (not x402) REST endpoint backing the Restyle Studio
web page: live PBR material editing, AI restyle, seeded colorway variants, and
texture swaps for any GLB. Not an MCP tool itself: the paid restyle_material
tool (listed under the agent tools below) and the web page both call it as a thin
client, so the free and paid surfaces share one implementation. See
api/_lib/material-studio-store.js and the
Material Studio API reference.
Every restyle and every persisted variant set is recorded in an immutable
parent → child version lineage — the same shape refine_model uses
(mcp-server/src/tools/_lineage.js) — so a caller can revert to, or branch off,
any earlier version. Pass the lineage array a previous call returned back in as
parent_lineage to extend one thread.
Paid 3D Studio — /api/mcp-3d
Generation tools price by tier (identical to POST /api/x402/forge); mesh-editing
and direction tools are flat per call.
| Tool | Price (USDC) | What it does |
|---|---|---|
text_to_3d |
tiered (draft/standard/high) | Text → textured GLB. |
image_to_3d |
tiered (draft/standard/high) | Image(s) → textured GLB. |
auto_rig_model |
$0.05 | Add an animation-ready skeleton to a GLB. |
capture_scene |
$0.05 | Video → 3D scene reconstruction (coloured point cloud). |
retexture_model |
$0.05 | Repaint a full mesh from a text prompt. |
retexture_region |
$0.05 | Magic-brush retexture of a masked region. |
stylize_model |
$0.02 | Voxel / brick / voronoi / lowpoly restyle. |
remesh_model |
$0.02 | Repair, simplify, or convert mesh format. |
segment_model |
$0.02 | Split a mesh into named parts. |
remove_background |
$0.01 | Cut a subject from a reference photo. |
pose_model |
$0.01 | Pose a rigged model from a text prompt. |
apply_animation |
$0.01 | Retarget a library clip onto a rigged GLB. |
direct_prompt |
$0.01 | Rewrite a vague idea into a tight 3D spec. |
generate_material |
$0.01 | PBR material parameters from a description. |
anchor_provenance |
$0.05 | Sign a content credential and anchor its hash on Solana. |
Free studio helpers (no charge): getting_started, generation_status,
preview_3d, list_animations, animation_signature, find_similar_animations,
text_to_animation, inspect_model, optimize_model, save_avatar, export_ar,
verify_provenance, grade_sim_readiness (the physics grade: whether a solver
could use a GLB as a rigid body, and exactly what is wrong when it could not,
see Simulation readiness; free so an agent can check ten
candidates before paying for one), x402_preflight (asks any x402 seller's
signed payability attestation whether it can actually settle before you pay it;
free on purpose and permanently), the persona tools (create_agent_persona, get_agent_persona,
persona_say, persona_identity, persona_tip, persona_send), and
validate_spatial_response (the Spatial MCP conformance gate).
Every catalog tool is either priced or on this explicit free list; a test fails
the build if a new tool is neither.
Agent & commerce tools — 3d-agent-local
The flagship agent server bundles avatar generation, market intel, naming,
reputation, and live agent-to-agent commerce. forge_free is the one free
generation lane; the rest are paid and quote their price in the
PaymentRequired challenge at call time.
| Tool | Price | What it does |
|---|---|---|
forge_free |
Free | Text → textured GLB on the free NVIDIA NIM (Microsoft TRELLIS) lane; returns a GLB URL + viewer link. |
crypto_news |
Free | Live crypto headlines from every publisher feed in the registry (api/_lib/news-sources.js, 27 categories, 17 languages), filterable by category, source, language, or search. |
crypto_news_digest |
Free | Clusters the last 1-72h of coverage into distinct narratives with stance, tickers, and covering outlets. |
news_resolve |
Free | Resolves one article URL into a bounded excerpt, summary, tickers and a structured trading read (assets with exposure and direction, priced-in, horizon, counter-argument). Blocked or paywalled pages are recovered from the Internet Archive, SEC EDGAR or sibling coverage; extraction names the lane. |
crypto_news_archive |
free quota, then $0.001/search | Search 660,000+ archived articles back to September 2017. Stats and trending modes are always free; search is free up to a daily per-IP quota, then $0.001 USDC per search via x402. |
text_to_avatar |
paid | Text → 3D avatar. |
mesh_forge |
paid | Text/image → 3D mesh via a Granite-directed model chain. |
rig_mesh |
paid | Auto-rig a GLB into an animation-ready model. |
forge_avatar |
paid | One call: text → rigged avatar (mesh + auto-rig, humanoid-gated). |
refine_model |
paid | Conversational iteration — describe a change ("make it metallic", "bigger helmet") on a prior model; anchored re-generation with a revertable/branchable version lineage. |
restyle_material |
paid | Re-skin a GLB without regenerating its mesh — AI PBR restyle from an instruction ("make it chrome", "wooden", "cyberpunk neon") or seeded, reproducible colorway variant fan-out from a PBR preset; parent → child lineage. See Restyle Studio. |
get_pose_seed |
paid | Pose generation. |
ens_sns_resolve |
paid | ENS + SNS name resolution. |
pump_snapshot |
paid ($0.005) | Live Solana token snapshot: Jupiter price, DexScreener volume/pair, pump.fun metadata, on-chain top-holder distribution. |
sentiment_pulse |
paid | Token sentiment pulse. |
agent_reputation |
paid | ERC-8004 agent reputation read. |
vanity_grinder |
paid | Solana vanity address mining. |
vanity_premium |
free | Browse the premium pre-ground vanity address inventory. |
aixbt_intel / aixbt_projects |
paid | Market narrative intel feed / momentum-ranked project scans. |
agenc_list_tasks / agenc_get_task / agenc_get_agent |
paid | AgenC coordination reads. |
agent_delegate_action |
paid | Agent-to-agent delegation. |
agent_hire_discover |
paid | Discover + reputation-rank agents to hire for a task. |
agent_hire |
paid | Hire an agent end to end: quote, settle USDC via x402, run it, return result + provenance receipt, with hard spend caps. |
Free vs. paid is fixed per tool; exact USDC amounts for the paid agent tools are quoted in each tool's
PaymentRequiredresponse at call time (and are tunable by the operator), so always read the challenge rather than assuming a figure.
Other MCP servers
| Server | File | Surface |
|---|---|---|
| Agent MCP | api/mcp-agent.js |
Agent build/control tools. |
| Bazaar MCP | api/mcp-bazaar.js |
x402 service discovery — see x402 bazaar. |
| IBM MCP | api/ibm-mcp.js |
watsonx / Granite integration — see IBM. |
| pump.fun MCP | api/pump-fun-mcp.js |
Launch/trade tools — see Solana pump.fun. |
| Viewer Control | api/chat/mcp.js |
Drives a live model viewer (wireframe, lighting, screenshots, load a model); tools in api/_lib/viewer-mcp-tools.js. |
$THREE only
Tools that reference a coin reference $THREE
(FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump). Tools that accept an arbitrary
token (pump_snapshot, sentiment_pulse) take the mint as runtime input and
promote no specific token.
Related
- MCP overview · 3D Studio MCP · 3D Studio (paid) · x402 bazaar
- x402 paid endpoints — the same capabilities over REST.
- MCP tool safety - what each tool's safety annotations mean, and the build check that verifies them against the code.
- The full catalog - every tool, searchable by safety and price.
