# three.ws MCP server

> Generates rigged GLB 3D avatars from text or photos and embeds them in apps, giving AI agents a 3D body and wallet.

- Repository: https://github.com/nirholas/three.ws
- Page: https://hostedmcp.org/servers/nirholas/three-ws
- Transport: remote
- Stars: 279
- License: Apache-2.0
- Latest version: 1.0.1

## Install

### Claude Code

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

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

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

### VS Code CLI

```sh
code --add-mcp '{"name":"three-ws","type":"http","url":"https://three.ws/api/mcp"}'
```

### Codex

```sh
codex mcp add three-ws --url https://three.ws/api/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.three-ws]
url = "https://three.ws/api/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http three-ws https://three.ws/api/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `AGENT_RELAYER_ADDRESS` | no | no |  |
| `AGENT_RELAYER_KEY` | no | no |  |
| `ANTHROPIC_API_KEY` | no | no |  |
| `AVATAR_REGEN_PROVIDER` | no | no |  |
| `AVATURN_API_KEY` | no | no |  |
| `CC_API_KEY` | no | no |  |
| `CC_SERVER_KEY` | no | no |  |
| `CC_SERVER_SECRET` | no | no |  |
| `CHAT_MAX_TOKENS` | no | no |  |
| `CHAT_MODEL` | no | no |  |
| `DATABASE_URL` | no | no |  |
| `JWT_KID` | no | no |  |
| `JWT_SECRET` | no | no |  |
| `MCP_EVM_PAYMENT_ADDRESS` | no | no |  |
| `MCP_SVM_PAYMENT_ADDRESS` | no | no |  |
| `PASSWORD_ROUNDS` | no | no |  |
| `PERMISSIONS_RELAYER_ENABLED` | no | no |  |
| `PINATA_JWT` | no | no |  |
| `PRIVY_APP_ID` | no | no |  |
| `PRIVY_APP_SECRET` | no | no |  |
| `PUBLIC_APP_ORIGIN` | no | no |  |
| `RESEND_API_KEY` | no | no |  |
| `RPC_URL_8453` | no | no |  |
| `RPC_URL_84532` | no | no |  |
| `S3_ACCESS_KEY_ID` | no | no |  |
| `S3_BUCKET` | no | no |  |
| `S3_ENDPOINT` | no | no |  |
| `S3_PUBLIC_DOMAIN` | no | no |  |
| `S3_SECRET_ACCESS_KEY` | no | no |  |
| `SENTRY_DSN` | no | no |  |
| `UPSTASH_REDIS_REST_TOKEN` | no | no |  |
| `UPSTASH_REDIS_REST_URL` | no | no |  |
| `VITE_AVATURN_DEVELOPER_ID` | no | no |  |
| `VITE_AVATURN_EDITOR_URL` | no | no |  |
| `VITE_CHARACTER_STUDIO_URL` | no | no |  |
| `VITE_PRIVY_APP_ID` | no | no |  |
| `WEB3_STORAGE_TOKEN` | no | no |  |

## Tools (4)

- `get_pose_seed`
- `pump_snapshot`
- `agent_reputation`
- `vanity_grinder`

## FAQ

### How do I generate a 3D model from text?

Open three.ws/forge, type a prompt like a brass steampunk owl, and download the resulting GLB. The draft tier is free and needs no account.

### Does the MCP server require an API key?

No. The mcp-studio endpoint is keyless, though authenticated servers are needed for your own library, agents and wallet.

### Which AI clients support this MCP server?

It works with Claude Code, Claude Desktop, Cursor, VS Code, Codex, Gemini CLI and OpenCode.

### What can the MCP tools do?

The 16 tools cover text to 3D, image to 3D, rigged avatars and talking personas.

### How do I install it in Claude Code?

Add the plugin marketplace and install the three-ws-3d plugin, or run the claude mcp add command with the HTTP transport URL.