# three.ws MCP API — 3D Avatar Agent Platform

> three.ws MCP API — 3D Avatar Agent Platform is a paid API for AI agents from three.ws, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Exposes MCP JSON-RPC tools for validating, inspecting, optimizing, and registering 3D avatar agents, plus searching public avatars and querying Solana reputation via IBM watsonx.ai-powered agents.

## Facts

- Endpoint: POST https://three.ws/api/mcp
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-mcp-api-3d-avatar-agent-platform-b83427b7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EpqjbAxAe3zcRxxWGL2a_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability three-ws-mcp-api-3d-avatar-agent-platform-b83427b7 -d '<json body>'
```

Example prompt: Use three.ws to validate my 3D avatar model with ID 'avatar_42' — call tools/call with validate_model and tell me if there are any warnings or vertex issues.

## When to prefer this

Choose this endpoint when you need programmatic access to three.ws 3D avatar tooling via the MCP protocol — especially for validating or optimizing 3D models, searching the public avatar directory, or interacting with Solana-based identity and reputation for avatar agents. Prefer this over the REST or embed-tag interface when automating agent workflows or integrating 3D avatar capabilities into an AI agent pipeline.

## Known failure modes

- Invalid MCP method name returns JSON-RPC error
- Missing jsonrpc '2.0' constant causes request rejection
- Unknown tool name in tools/call params returns tool-not-found error
- Malformed params object for a tool returns validation error
- Payment not attached (x402) results in 402 Payment Required before processing
- Solana registration fails if wallet address is invalid or network is congested

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

A JSON-RPC 2.0 response containing a result object with content array; each content item has a text field with a JSON string including ok status, warnings array, and meta object (e.g. vertex count). Tool output varies by tool called — search returns listings, reputation returns scores, registration returns on-chain confirmation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "type": [
    "string",
    "number"
   ]
  },
  "method": {
   "enum": [
    "initialize",
    "tools/list",
    "tools/call",
    "ping"
   ],
   "type": "string",
   "description": "MCP JSON-RPC method."
  },
  "params": {
   "type": "object",
   "description": "For tools/call: { name, arguments }. Tool names include validate_model, inspect_model, optimize_model, search_public_avatars, register_agent, solana_agent_reputation, and others, see tools/list."
  },
  "jsonrpc": {
   "type": "string",
   "const": "2.0"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": 1,
  "result": {
   "content": [
    {
     "text": "{\"ok\":true,\"warnings\":[],\"meta\":{\"vertices\":12345}}",
     "type": "text"
    }
   ]
  },
  "jsonrpc": "2.0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-mcp-api-3d-avatar-agent-platform-b83427b7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)