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.

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.json
index 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.js
index 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