{"uid":"cap_EpqjbAxAe3zcRxxWGL2a_","slug":"three-ws-mcp-api-3d-avatar-agent-platform-b83427b7","name":"three.ws MCP API — 3D Avatar Agent Platform","description":"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.","url":"https://three.ws/api/mcp","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"type":"json","example":{"id":1,"result":{"content":[{"text":"{\"ok\":true,\"warnings\":[],\"meta\":{\"vertices\":12345}}","type":"text"}]},"jsonrpc":"2.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_34B8WjlHKzJ9vefWeRS5h","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:33:53.960Z","isFirstParty":false}