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.
three.ws — Paid API Provider
Website: https://three.ws
Discovery: https://three.ws/.well-known/x402.json
OpenAPI: https://three.ws/openapi.json
MCP: https://three.ws/api/mcp
Networks: Solana mainnet (USDC, leads every accepts list), Base mainnet (USDC), Arbitrum One (USDC, model-check only)
Protocol: x402 v2 (HTTP 402 Payment Required)
Overview
three.ws is an agent-first 3D model platform. Paid REST endpoints cover glTF/GLB model validation, Solana token visualization, Pump.fun agent analytics, on-chain identity verification, and a Claude-backed growth-analysis power. All endpoints settle in USDC (or $THREE) on Solana mainnet, with Base (and Arbitrum for model-check) as the alternative EVM rails; Solana is the first accept in every 402 challenge, so a client that takes the first accept settles there. The MCP server exposes the same surface as JSON-RPC tools.
Paid Endpoints
This table mirrors the live /.well-known/x402.json resource catalog. Prices below
are the source of truth and match what the 402 challenges advertise; verify with
npx x402-surface-check https://three.ws/.well-known/x402.json.
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/mcp |
POST | $0.001 | MCP 2025-06-18 Streamable HTTP — 3D model tools + Solana agent data as JSON-RPC 2.0 |
/api/x402/model-check |
GET | $0.001 | Fetch a glTF/GLB from a URL, return vertex/triangle counts, materials, textures, animations, extensions, and optimization hints. CDP-Bazaar-cataloged. |
/api/x402/mint-to-mesh |
GET | $0.001 | Pass a Solana SPL mint, get a binary glTF (GLB) cube themed for that token (color + texture derived from on-chain metadata: the Token-2022 metadata extension when the mint carries one, else the Metaplex PDA). CDP-Bazaar-cataloged. |
/api/x402/symbol-availability |
GET | $0.001 | Pre-launch ticker collision check against three.ws's pump.fun mint index; returns exact and trigram-similar matches |
/api/x402/skill-marketplace |
GET | $0.001 | List active skill listings and prices across all three.ws agents; filter by skill name to find the cheapest provider |
/api/x402/permit2-paid-demo |
GET | $0.001 | Permit2 + EIP-2612 gas-sponsoring demo (Base only). Forces the gasless Permit2 path for fresh wallets holding USDC but zero ETH. Listed only when CDP credentials are configured. |
/api/x402/onchain-identity-verify |
GET | $0.005 | Verify an agent's ownership of a Solana contract/mint from three.ws's on-chain identity index; returns tx_hash + wallet evidence |
/api/x402/agent-reputation |
GET | $0.01 | Reputation snapshot for a three.ws agent: USDC paid in, distinct payers, deployed mints, distribution success rate, attestation count |
/api/x402/fact-check |
POST | $0.10 | Sourced fact-check verdict (supported/contradicted/mixed/insufficient) with cited sources, authority weights, and a SHA-256 attestation |
/api/x402/mint-to-mesh-batch |
POST | $0.05 | Resolve 1–10 Solana SPL mints to themed GLB cubes in one call; per-mint failures report individually |
/api/x402/pump-launch |
POST | $5.00 | Deploy a brand-new pump.fun token in one paid call. Supply name + symbol + (metadataUri or imageUrl); the server fronts the SOL deploy cost and signs the create-coin tx. Creator rewards accrue to any Solana wallet you nominate, or pass holderReward: true to route creator fees to holders through the pump.fun holder-rewards PDA; optional vanity mint address. Returns mint + tx signature + pump.fun URL |
All prices are in USDC with 6 decimals. $0.001 = 1000 atomics.
Quick Start
import { withPaymentInterceptor } from "@x402/fetch";
import fetch from "node-fetch";
const fetchWithPayment = withPaymentInterceptor(fetch, wallet);
// Check a 3D model
const res = await fetchWithPayment(
"https://three.ws/api/x402/model-check?url=https://three.ws/avatars/cesium-man.glb"
);
const { model, suggestions } = await res.json();
// Get a token's 3D representation
const res2 = await fetchWithPayment(
"https://three.ws/api/x402/mint-to-mesh?mint=FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump"
);
const { glb } = await res2.json(); // base64 GLB bytes
MCP Usage
{
"mcpServers": {
"three-ws": {
"url": "https://three.ws/api/mcp",
"headers": { "x-payment": "<usdc-payment-token>" }
}
}
}
CORS
All paid endpoints (/api/mcp, /api/x402/*) and the
public discovery docs (/.well-known/x402, /.well-known/x402.json, /openapi.json)
respond with Access-Control-Allow-Origin: * on both the OPTIONS preflight and the
actual request. The CORS layer also exposes PAYMENT-REQUIRED, x-payment-response,
x-payment-network, and x-payment-tx so browser-based agents can drive the 402-pay-retry
flow and surface settlement receipts. Both server-to-server and browser-agent paths
are supported.
Notes
- All endpoints return structured JSON 402 challenges before access; probe with
npx x402-surface-check https://three.ws/.well-known/x402.jsonto enumerate live prices. - Every 402 challenge echoes the resource URL both at top-level
resource.urlAND in eachaccepts[].resource, so wallet/facilitator spend logs reconcile cleanly without relying on the buyer to remember which endpoint they hit. - Solana accepts normally carry
extra.feePayer(the platform sponsor, included automatically in the 402 challenge), and an external facilitator such as PayAI requires it at/verify. When three.ws settles in-house and the sponsor wallet cannot co-sign, the accept is advertised withoutfeePayer: the buyer signs as their own fee payer (self-pay) and needs a little SOL for the network fee. - On Solana,
$THREEis offered as a second accept alongside USDC on the same challenge. - No public key-generation endpoints. three.ws does not run any server-side vanity-key or keypair-generation paid endpoint — wallet keys never leave the buyer's environment.