three.ws 3D Agent Tools — MCP server for Claude Code: text into 3D
An MCP server bundling three.ws tools: build 3D models from a text prompt or a reference image, rig a mesh, assemble avatars, and pull market data. Some calls cost nothing, the rest are billed per call.
claude mcp add --env MCP_SVM_PAYMENT_ADDRESS=<MCP_SVM_PAYMENT_ADDRESS> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env HELIUS_API_KEY=<HELIUS_API_KEY> --transport stdio mcp-server -- npx -y @three-ws/mcp-serverWhat three.ws 3D Agent Tools does
There are 26 tools. The free ones cover forge_free, which turns a text prompt into a textured GLB on the no-cost NVIDIA NIM (Microsoft TRELLIS) lane, browsing pre-ground premium vanity inventory, and a crypto news set: crypto_news, crypto_news_digest, news_resolve. Archive search stays free within a daily quota, then costs $0.001 USDC per query.
Paid tools start with mesh_forge at $0.25 for a mesh from a prompt or a reference image, and rig_mesh at $0.20, which fits a humanoid skeleton plus per-vertex weights onto a static GLB. forge_avatar at $0.45 runs the entire chain in a single call, ending with an animation-ready avatar. In text mode mesh_forge first has IBM Granite rewrite the prompt, then FLUX renders a reference and TRELLIS or Tencent Hunyuan3D reconstructs the mesh.
Settlement happens in USDC through the x402 protocol on Solana mainnet with the exact scheme. No subscription and no API key; a failed call is never charged. Server operators who want to receive payouts pass a wallet address and a Helius key, and without HELIUS_API_KEY some configurations will not start. Every tool declares MCP annotations (readOnlyHint, destructiveHint), and none of them destroys anything.
What it helps with
- build a 3D model from a written description at no cost
- turn a reference image into a textured GLB
- add a skeleton to a static model for animation
- produce an animation-ready avatar in one call
- pull crypto news and market data into an agent
Example prompts for the agent
- Generate a 3D model from the prompt "low-poly robot" with
forge_free - Make a mesh from
reference.pngusingmesh_forge - Rig
model.glbwithrig_mesh
How to install three.ws 3D Agent Tools
Platform CLI
claude mcp add --env MCP_SVM_PAYMENT_ADDRESS=<MCP_SVM_PAYMENT_ADDRESS> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env HELIUS_API_KEY=<HELIUS_API_KEY> --transport stdio mcp-server -- npx -y @three-ws/mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add mcp-server --env MCP_SVM_PAYMENT_ADDRESS=<MCP_SVM_PAYMENT_ADDRESS> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env HELIUS_API_KEY=<HELIUS_API_KEY> -- npx -y @three-ws/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@three-ws/mcp-server"
],
"env": {
"MCP_SVM_PAYMENT_ADDRESS": "<MCP_SVM_PAYMENT_ADDRESS>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
"HELIUS_API_KEY": "<HELIUS_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/mcp-server"
],
"env": {
"MCP_SVM_PAYMENT_ADDRESS": "<MCP_SVM_PAYMENT_ADDRESS>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
"HELIUS_API_KEY": "<HELIUS_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MCP_SVM_PAYMENT_ADDRESS=<MCP_SVM_PAYMENT_ADDRESS> -e SOLANA_RPC_URL=<SOLANA_RPC_URL> -e HELIUS_API_KEY=<HELIUS_API_KEY> mcp-server npx -y @three-ws/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about three.ws 3D Agent Tools
How do I install three.ws 3D Agent Tools in Claude Code?
Run claude mcp add 3d-agent-mcp -e HELIUS_API_KEY=<HELIUS_API_KEY> -- npx -y @three-ws/mcp-server. For payouts and a custom RPC, use the longer form: `claude mcp add --env MCP_SVM_PAYMENT_ADDRESS=<MCP_SVM_PAYMENT_ADDRESS> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env HELIUS_API_KEY=<HELIUS_API_KEY> --transport stdio mcp-server -- npx -y @three-ws/mcp-server`.
What does three.ws 3D Agent Tools do?
It hands the agent 3D generation tools: text or an image becomes a GLB, a static mesh gets a skeleton, and an avatar comes out of one call. A separate set returns crypto news and market data.
Do the free tools need an API key?
No. forge_free, vanity_premium, crypto_news, crypto_news_digest and news_resolve run with no wallet, payment or key.
