Skip to content

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.

4.1 KB
Raw Blame

Install three.ws in your agent

three.ws is a set of hosted MCP servers (Streamable HTTP, JSON-RPC 2.0). Add one URL to any MCP client, or run one command to configure several clients at once.

One command

Signs you in, writes the servers into every MCP client it finds, and verifies each with a live tools/list. Requires Node.js 20.12 or newer.

npx three-ws setup

One command signs you in (OAuth or API key), writes these servers into Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI or Hermes, prints a ready Grok Bot connector (npx three-ws setup --client grok-bot), and verifies each with a live tools/list.

Full CLI reference: https://three.ws/docs/cli.md

Per client

Claude (claude.ai and Claude desktop)

Server: https://three.ws/api/mcp. Auth: oauth2.1. Where: Customize, Connectors, Add custom connector.

Claude Code

Server: https://three.ws/api/mcp. Auth: oauth2.1. Where: claude mcp add, or /mcp inside Claude Code.

claude mcp add --transport http three-ws-main https://three.ws/api/mcp

ChatGPT

Server: https://three.ws/api/mcp. Auth: oauth2.1. Where: Settings, Apps and Connectors, Advanced settings (turn on Developer mode), then Create.

Cursor

Server: https://three.ws/api/mcp. Auth: oauth2.1. Where: mcp.json or the Add to Cursor button on the connect page.

{
  "mcpServers": {
    "three-ws": {
      "url": "https://three.ws/api/mcp"
    }
  }
}

VS Code

Server: https://three.ws/api/mcp. Auth: oauth2.1. Where: .vscode/mcp.json or the Add to VS Code button on the connect page.

{
  "servers": {
    "three-ws": {
      "type": "http",
      "url": "https://three.ws/api/mcp"
    }
  }
}

Grok Bot (xAI)

Server: https://three.ws/api/mcp-grok. Auth: none. Where: Connectors, add a custom MCP connector.

The URL must be public: Grok Bot connects from xAI's cloud, so a localhost URL never works.

Add sign-in later for the account's agent, memory, skill and avatar tools; never a wallet or payment tool: https://three.ws/api/mcp-grok?auth=oauth

IBM Bob

Server: https://three.ws/api/mcp-studio. Auth: none. Where: .bob/mcp.json in the project, or ~/.bob/settings/mcp.json for every workspace (Bob panel, MCP tab, Edit Project MCP or Edit Global MCP).

{
  "mcpServers": {
    "three-ws": {
      "type": "streamable-http",
      "url": "https://three.ws/api/mcp-studio"
    }
  }
}

Bob Shell reads the same files but names the URL key httpURL.

Add sign-in later for the account's agents, memory, wallets and x402 tools, through Bob's built-in OAuth on first connect: https://three.ws/api/mcp

Hosted MCP servers

Server Endpoint Auth
three.ws https://three.ws/api/mcp OAuth 2.1 (end-user), API key (server-to-server), or x402 pay-per-call
3D Studio https://three.ws/api/mcp-3d OAuth 2.1 or x402 pay-per-call
3D Studio (free) https://three.ws/api/mcp-studio none
Grok https://three.ws/api/mcp-grok OAuth 2.1 or a connector API key for the account's agent tools; none needed for the free 3D tools
Agent wallet https://three.ws/api/mcp-agent OAuth 2.1
x402 Bazaar https://three.ws/api/mcp-bazaar OAuth 2.1 or x402
pump.fun https://three.ws/api/pump-fun-mcp none for the read-only tools; API key or x402 for pumpfun_upload_metadata
IBM x402 https://three.ws/api/ibm-mcp x402 pay-per-call (authenticated three.ws principals call without per-call payment)

No account is needed for the keyless servers (3D Studio free, read-only pump.fun tools).

More