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.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
fix(mcp): reconcile mcp.json clients schema, restore grok auth-text word order
nirholas65e8fbf7dc2b
diff --git a/public/.well-known/mcp.json b/public/.well-known/mcp.jsonindex 1aadd24c7..37cff1531 100644--- a/public/.well-known/mcp.json+++ b/public/.well-known/mcp.json@@ -10,132 +10,126 @@"documentation": "https://three.ws/docs/cli"},"clients": {- "$comment": "Per-client setup for the servers above, so an agent can connect three.ws without a human. A three.ws extension that no MCP spec defines: ignore clients and fields you do not recognize. 'server' is always one of servers[].endpoint, 'auth' is one of none, oauth or api-key, and 'settings' holds the exact values for the client's own form or config file. Human version: https://three.ws/connect",+ "$comment": "three.ws extension, not part of any MCP spec: per-client setup hints so an agent can connect without a human. Consumers must ignore unknown fields. Each recommendedServer is an endpoint listed in servers[].",+ "documentation": "https://three.ws/connect","claude": {- "name": "Claude (claude.ai and Claude Desktop)",- "server": "https://three.ws/api/mcp",- "auth": "oauth",+ "name": "Claude (claude.ai and Claude desktop)",+ "recommendedServer": "https://three.ws/api/mcp",+ "auth": "oauth2.1","settings": {- "Name": "three.ws",- "Remote MCP server URL": "https://three.ws/api/mcp"+ "where": "Customize, Connectors, Add custom connector",+ "fields": {+ "name": "three.ws",+ "url": "https://three.ws/api/mcp"+ }},- "installLink": "https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=three.ws&connectorUrl=https%3A%2F%2Fthree.ws%2Fapi%2Fmcp",- "steps": [- "Open the install link, check the name and URL, then click Add. By hand: Customize, Connectors, Add custom connector, paste the URL.",- "Click Connect and sign in to three.ws. Read the permissions before you approve.",- "In a chat, open the + menu, then Connectors, and switch three.ws on for that conversation."- ],- "setup": "https://three.ws/connect?client=claude"+ "deepLink": "https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=three.ws&connectorUrl=https%3A%2F%2Fthree.ws%2Fapi%2Fmcp",+ "guide": "https://three.ws/connect"},- "chatgpt": {- "name": "ChatGPT",- "server": "https://three.ws/api/mcp",- "auth": "oauth",+ "claude-code": {+ "name": "Claude Code",+ "recommendedServer": "https://three.ws/api/mcp",+ "auth": "oauth2.1","settings": {- "Name": "three.ws",- "MCP Server URL": "https://three.ws/api/mcp",- "Authentication": "OAuth"+ "where": "claude mcp add, or /mcp inside Claude Code",+ "fields": {+ "name": "three-ws-main",+ "url": "https://three.ws/api/mcp"+ }},- "steps": [- "In Settings, Apps & Connectors, Advanced settings, turn on Developer mode.",- "Back in Apps & Connectors, click Create, enter the settings and create it.",- "Sign in to three.ws when ChatGPT asks, and approve the permissions.",- "In a new chat, open the + menu, choose Developer mode, and tick three.ws."- ],- "setup": "https://three.ws/connect?client=chatgpt"+ "command": "claude mcp add --transport http three-ws-main https://three.ws/api/mcp",+ "guide": "https://three.ws/connect?client=claude-code"},- "grok-bot": {- "name": "Grok Bot",- "server": "https://three.ws/api/mcp-grok",- "auth": "none",+ "chatgpt": {+ "name": "ChatGPT",+ "recommendedServer": "https://three.ws/api/mcp",+ "auth": "oauth2.1","settings": {- "Name": "three-ws-grok",- "Transport": "Streamable HTTP",- "Server URL": "https://three.ws/api/mcp-grok",- "Authentication": "None"- },- "say": "Add a custom MCP server called three-ws-grok at https://three.ws/api/mcp-grok",- "alternatives": [- {- "auth": "none",- "use": "A free quota of its own that survives reconnects, for scheduled tasks: POST the install endpoint and connect the connector_urls.grok value it returns.",- "install": "https://three.ws/api/mcp-studio/install"- },- {- "auth": "api-key",- "use": "The account's agents, memory and skills. Make a key for an AI agent at the keys page and store it as a Bot secret. A connector key never spends.",- "keys": "https://three.ws/dashboard/api",- "header": "Authorization",- "value": "Bearer <three.ws API key>"- },- {- "auth": "oauth",- "use": "The account's agents, memory and skills, signed in once in the browser.",- "url": "https://three.ws/api/mcp-grok?auth=oauth"+ "where": "Settings, Apps and Connectors, Advanced settings (turn on Developer mode), then Create",+ "fields": {+ "name": "three.ws",+ "url": "https://three.ws/api/mcp",+ "authentication": "OAuth"}- ],- "steps": [- "In Grok Bot, open Connectors and add a custom MCP server with the settings above, or send Grok Bot the say sentence and confirm what it shows.",- "Check the name and URL Grok Bot shows, then confirm.",- "Ask for 3D in any task, or attach the server with @ and its name."- ],- "notes": "Grok Bot connects from xAI's cloud, so only a public URL works; never localhost.",- "setup": "https://three.ws/connect?client=grok",- "documentation": "https://three.ws/docs/grok-bot"+ },+ "guide": "https://three.ws/connect"},"cursor": {"name": "Cursor",- "server": "https://three.ws/api/mcp",- "auth": "oauth",+ "recommendedServer": "https://three.ws/api/mcp",+ "auth": "oauth2.1","settings": {- "file": "~/.cursor/mcp.json",+ "where": "mcp.json or the Add to Cursor button on the connect page","config": {"mcpServers": {- "three-ws-main": {+ "three-ws": {"url": "https://three.ws/api/mcp"}}}},- "installLink": "cursor://anysphere.cursor-deeplink/mcp/install?name=three-ws-main&config=eyJ1cmwiOiJodHRwczovL3RocmVlLndzL2FwaS9tY3AifQ%3D%3D",- "steps": [- "Open the install link, or add the config to the file.",- "Cursor runs the three.ws sign-in on first use."- ],- "setup": "https://three.ws/connect?client=cursor"+ "guide": "https://three.ws/connect"},"vscode": {- "name": "VS Code (GitHub Copilot agent mode)",- "server": "https://three.ws/api/mcp",- "auth": "oauth",+ "name": "VS Code",+ "recommendedServer": "https://three.ws/api/mcp",+ "auth": "oauth2.1","settings": {- "file": ".vscode/mcp.json",+ "where": ".vscode/mcp.json or the Add to VS Code button on the connect page","config": {"servers": {- "three-ws-main": {+ "three-ws": {"type": "http","url": "https://three.ws/api/mcp"}}}},- "installLink": "vscode:mcp/install?%7B%22name%22%3A%22three-ws-main%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fthree.ws%2Fapi%2Fmcp%22%7D",- "steps": [- "Open the install link, or add the config to the file.",- "The server signs you in on first use."- ],- "setup": "https://three.ws/connect?client=vscode"+ "guide": "https://three.ws/connect"},- "claude-code": {- "name": "Claude Code",- "server": "https://three.ws/api/mcp",- "auth": "oauth",- "command": "claude mcp add --transport http three-ws-main https://three.ws/api/mcp",- "steps": [- "Run the command.",- "In Claude Code, type /mcp, pick three-ws-main and choose Authenticate."- ],- "setup": "https://three.ws/connect?client=claude-code"+ "grok-bot": {+ "name": "Grok Bot (xAI)",+ "recommendedServer": "https://three.ws/api/mcp-grok",+ "auth": "none",+ "authUpgrade": {+ "mode": "oauth2.1",+ "url": "https://three.ws/api/mcp-grok?auth=oauth",+ "adds": "the account's agent, memory, skill and avatar tools; never a wallet or payment tool"+ },+ "settings": {+ "where": "Connectors, add a custom MCP connector",+ "fields": {+ "transport": "streamable-http",+ "url": "https://three.ws/api/mcp-grok",+ "authentication": "none"+ },+ "note": "The URL must be public: Grok Bot connects from xAI's cloud, so a localhost URL never works."+ },+ "skill": "https://three.ws/grok-skill.md",+ "guide": "https://three.ws/grok"+ },+ "ibm-bob": {+ "name": "IBM Bob",+ "recommendedServer": "https://three.ws/api/mcp-studio",+ "auth": "none",+ "authUpgrade": {+ "mode": "oauth2.1",+ "url": "https://three.ws/api/mcp",+ "adds": "the account's agents, memory, wallets and x402 tools, through Bob's built-in OAuth on first connect"+ },+ "settings": {+ "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)",+ "config": {+ "mcpServers": {+ "three-ws": {+ "type": "streamable-http",+ "url": "https://three.ws/api/mcp-studio"+ }+ }+ },+ "note": "Bob Shell reads the same files but names the URL key httpURL."+ },+ "guide": "https://three.ws/connect?client=bob&server=three-ws-studio"}},"registry": "https://registry.modelcontextprotocol.io/?q=io.github.nirholas",@@ -198,9 +192,19 @@"auth": "OAuth 2.1 or x402 pay-per-call","description": "Paid text-to-3D and image-to-3D generation, rigging, retexture, and optimization.","documentation": "https://three.ws/docs/mcp-3d-studio",- "resources": ["three://me", "three://agents", "three://models"],- "resourceTemplates": ["three://agents/{agentId}", "three://assets/{id}"],- "prompts": ["get-started", "generate-3d"]+ "resources": [+ "three://me",+ "three://agents",+ "three://models"+ ],+ "resourceTemplates": [+ "three://agents/{agentId}",+ "three://assets/{id}"+ ],+ "prompts": [+ "get-started",+ "generate-3d"+ ]},{"name": "3D Studio (free)",@@ -209,13 +213,18 @@"auth": "none","description": "Free text-to-3D, image-to-3D, rigged avatars, persistent talking personas, and a search of the ready-made asset catalog. No account, no payment.","documentation": "https://three.ws/docs/mcp-studio",- "prompts": ["agent-get-started", "daily-3d-brief", "asset-pack", "avatar-from-photo"]+ "prompts": [+ "agent-get-started",+ "daily-3d-brief",+ "asset-pack",+ "avatar-from-photo"+ ]},{"name": "Grok","endpoint": "https://three.ws/api/mcp-grok","transport": "streamable-http",- "auth": "none for the free 3D tools; OAuth 2.1 or a connector API key adds the account's agent tools",+ "auth": "OAuth 2.1 or a connector API key for the account's agent tools; none needed for the free 3D tools","signIn": "https://three.ws/api/mcp-grok?auth=oauth","description": "One connector URL for Grok Bot and the xAI API: the free 3D studio with agent-ready links and no widgets, plus your agents, their memory and skills once signed in. Never lists a wallet or payment tool.","documentation": "https://three.ws/docs/grok",@@ -273,9 +282,18 @@"auth": "OAuth 2.1 or x402","description": "Discover, browse, and price paid agent services across the x402 facilitator network.","documentation": "https://three.ws/docs/mcp-x402-bazaar",- "resources": ["three://me", "three://x402/services", "three://marketplace"],+ "resources": [+ "three://me",+ "three://x402/services",+ "three://marketplace"+ ],"resourceTemplates": [],- "prompts": ["get-started", "hire-agent", "explore-marketplace", "explore-x402"]+ "prompts": [+ "get-started",+ "hire-agent",+ "explore-marketplace",+ "explore-x402"+ ]},{"name": "pump.fun",diff --git a/tests/mcp-directory.test.js b/tests/mcp-directory.test.jsindex fa56cedae..1c7b0b91a 100644--- a/tests/mcp-directory.test.js+++ b/tests/mcp-directory.test.js@@ -11,7 +11,7 @@ const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');const directory = JSON.parse(readFileSync(resolve(ROOT, 'public/.well-known/mcp.json'), 'utf8'));const vercel = JSON.parse(readFileSync(resolve(ROOT, 'vercel.json'), 'utf8'));-const CLIENTS = ['claude', 'chatgpt', 'cursor', 'vscode', 'grok-bot', 'ibm-bob'];+const CLIENTS = ['claude', 'claude-code', 'chatgpt', 'cursor', 'vscode', 'grok-bot', 'ibm-bob'];const AUTH_MODES = ['none', 'oauth2.1', 'api-key'];// A path is served when a route in vercel.json rewrites it, or, as for every