threews-avatar-mcpSAFE
MCP server for three.ws 3D avatars by three.ws — render a live, rotatable on-chain avatar inline (interactive MCP App), get a paste-anywhere embed iframe, or fetch avatar metadata. Free, no API key.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
@three-ws/avatar-mcp
An MCP server that drops a live, rotatable 3D avatar into any chat — interactive in the conversation, embeddable anywhere. Free, no API key.
Install · Setup · Quick start · Tools · Requirements · three.ws
A thin, zero-config, read-only Model Context Protocol server that brings three.ws 3D avatars into any MCP client — Claude Desktop, Claude Code, Cursor, or any other host. Render a live, rotatable avatar inline, get a paste-anywhere embed iframe, or fetch avatar metadata. Every tool reads live from the real three.ws endpoints — no mock data. Public and unlisted avatars need no API key. Registry name: io.github.nirholas/threews-avatar. Built by [three9e2e19f7d01dOBSERVED · 2026-10-10Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add avatar-mcp -- npx -y @three-ws/[email protected]
Exposed tools (2)
2 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
avatar | read | Avatar id (UUID) or three.ws @handle, e.g. |
showcase-avatar | read | Render a three.ws 3D avatar live and inline (interactive, rotatable) and produce its |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (1 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (2)
.nojekyll
@modelcontextprotocol/sdk, @modelcontextprotocol/ext-apps, esbuild
Gates applied: no_behavioural_pass.
9e2e19f7d01dfull audit observations/trust-audit/mcp-server/nirholas__threews-avatar-mcp.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-10 | 9e2e19f7d01d | SAFE | B | 89 | first audit |
Questions
What is the threews-avatar-mcp MCP server?
MCP server for three.ws 3D avatars by three.ws — render a live, rotatable on-chain avatar inline (interactive MCP App), get a paste-anywhere embed iframe, or fetch avatar metadata. Free, no API key.
What tools does threews-avatar-mcp expose?
2 in total: 2 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is threews-avatar-mcp safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does threews-avatar-mcp need?
No credential environment variables were found in its source, so it appears to need none.
How does threews-avatar-mcp run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as @three-ws/avatar-mcp at 0.3.2.
How current is this page?
The grade is for one exact copy of the source (9e2e19f7d01d), read on 2026-10-10. The repository is watched and re-audited when it changes.