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.

14.3 KB
Raw Blame

packages/

Publishable npm packages for the three.ws platform: client SDKs, agent tooling, and a large family of MCP servers under the @three-ws/* scope. Several are npm workspaces declared in the root package.json. Publishing is decided by the filesystem, not by a hand-kept list: a directory holding a server.json publishes through npm run publish:mcp (npm plus the official MCP registry), everything else with a non-private package.json through npm run publish:packages (both have --dry-run variants). npm run sync:repos stages each one as a standalone GitHub mirror under dist/standalone-mirrors/ and prints the push command; publishing is the owner's call. data/standalone-mirrors.json is the source of truth for which directory maps to which repo. The full runbook, including the publish preflight, is in docs/contributing.md. Each package's README covers its install, API, and examples.

Package Description
activity-mcp Read-only MCP server for live discovery: trending agents and coins, the $THREE holder leaderboard, and the activity ticker.
agenc Client SDK for the AgenC agent-coordination protocol on Solana: tasks, lifecycle, and the agent registry.
agenc-mcp MCP server for AgenC coordination: on-chain task marketplace, agent registry, and x402 service discovery.
agent-glance Puts a live three.ws agent on any surface with a slot: home-screen widgets, README badges, Slack unfurls, and an <agent-glance> web component.
agent-guards Per-agent spend policies and trade guards that cap what an agent can spend before a transaction is signed.
agent-memory Persistent embeddings-backed memory for agents: store facts, recall semantically, surface working context.
agent-runtime The three.ws agent engine: a plan and execute decision loop with human-approval gates and a seven-layer GuardChain.
agent-sniper Embeddable pump.fun sniper engine: library, CLI, MCP server, and x402 paid API.
agent-vitals Capability attestation for agents: models an agent's preconditions as a causal graph and returns the root blocker plus the command that clears it.
agentcore-payments-mcp MCP server for platform-managed payment sessions: budgeted, governed x402 spending without private keys.
agora-mcp MCP server for Agora, the agent and human economy: job board, economy pulse, passports, and signed real work.
alerts-mcp MCP server to manage pump.fun alert rules with in-app, webhook, and Telegram delivery.
alibaba-cloud-mcp MCP server for Alibaba Cloud DashScope: Qwen chat, embeddings, and model discovery with your own key.
assistant-mcp MCP server that generates paste-ready three.ws assistant widget embed code, offline and deterministic.
audio-mcp MCP server for voice and face: TTS, STT, audio-to-face lipsync, and the motion-capture clip library.
autopilot-mcp MCP server for an agent's autonomous-execution control plane: scopes, daily spend cap, and the propose, execute, undo loop.
avatar-agent-mcp MCP server that spawns a textured GLB avatar with a Solana wallet, a voice, and pump.fun launch powers.
avatar-cli Terminal tooling to scaffold, validate, hash, and preview avatar manifests from your shell or CI.
avatar-schema JSON Schema and validator for three.ws on-chain avatar manifests.
avatar-stream Progressive 3D over plain HTTP: a layered A3S stream whose first 50 KB is already a complete, skinned avatar, refined in place by byte-range requests.
billing-mcp Read-only MCP server for account economics: quotas, metered usage, invoices, receipts, and earnings.
brain-mcp MCP server for the multi-provider LLM router: discover models and run chat completions through any of them.
brownout Data-provenance headers plus request-scoped fault injection, so you can break an API's upstreams on purpose and prove your integration survives it.
clash-mcp MCP server for Coin Clash: read the live battle board, or enlist a wallet and rally power for a faction.
concierge-mcp MCP server that answers grounded questions about any website and generates Concierge embed code.
copy-mcp MCP server to manage copy-trade follows: leaders, sizing and guard rules, intent inbox, and fees owed.
create-agent One command from a sentence to a rigged, animated 3D agent: npm create @three-ws/agent.
defi-utils Zero-dependency chain IDs, token addresses, ERC-20 ABI fragments, and address validation for EVM chains and Solana.
forge Generation SDK: text, image, or sketch to a textured, rig-ready GLB in one call.
glb-diff Structural diff for glTF/GLB: geometry, materials, textures, skeletons, and animations, with rename detection, as a library and a CI-ready CLI.
glb-tools Inspect, re-theme, and bake GLB models from the shell or CI over live three.ws endpoints.
guardian Content safety and governance: risk classification, moderation, autonomous-send caps, and a tamper-evident audit ledger.
herald-mcp MCP server that has a 3D character walk onto the browser tab a human already has open and say something out loud.
home-bridge Connects an agent to a real Home Assistant instance: live entity state, guarded service calls, and a room graph for the 3D scene.
home-mcp MCP server giving an assistant safe control of a real Home Assistant house, behind a gate that refuses anything which opens the building.
ibm-watsonx-mcp MCP server for IBM watsonx.ai with Granite foundation models, using your own IBM Cloud credentials.
ibm-x402-mcp x402 pay-per-use MCP server for IBM Granite AI, paid in USDC on Solana, no IBM account required.
intel Intelligence SDK: sentiment pulse, narrative intel, momentum-ranked scans, and live Solana token snapshots.
intel-mcp Read-only MCP server for market intelligence: smart-money scoring, wallet intel, signals, and KOL leaderboards.
irl Client for geofenced real-world presence: check-ins, nearby discovery, encounters, drops, and proof-of-presence quests.
knock-mcp MCP server to reach a real person: read what they charge, browse open doors, knock, and read the reply. Quotes paid doors, holds no wallet.
knock-sdk Publish a priced door and let anyone pay to send one message through, delivered in person by the recipient's 3D companion.
kol-mcp Read-only MCP server for one tracked KOL wallet: portfolio P&L and its trades on a given mint.
loom-mcp MCP server for the Loom community 3D-creation gallery: browse the feed, fetch a creation, submit your own.
marketplace-mcp Read-only MCP server for the agent marketplace and skills catalog.
metaplex-agent-mcp MCP server that deploys an agent on-chain into the Metaplex Agent Registry on Solana in one atomic transaction.
mocap Motion capture as an API: webcam or video to face, pose, and hand animation clips, replayable on any avatar.
motion Text and structure to a three.js AnimationClip: forward and inverse kinematics, balance, ground contact, and secondary motion, with no mocap data.
names ENS and SNS name resolution, threews.sol subdomain minting, and pay-by-name in one import.
naming-mcp MCP server to resolve .sol names and check threews.sol agent-handle availability.
notifications-mcp MCP server for the notification inbox: list events, mark read, tune delivery, register Web Push devices.
onchain-agent-wallets Gives an agent a real Solana wallet with a spending allowance instead of your keys.
oracle-model The three.ws Oracle conviction model running locally: score any pump.fun launch offline from the real bucket weights, no API key.
portal Turns any website into a walkable 3D city: sections become buildings, links become doors, images become billboards.
portfolio-mcp MCP server for an agent's trading state: portfolio, balances, PnL feed, and one signed Solana transfer.
pose Deterministic named pose seeds: a natural-language prompt to a stable seed and full joint-rotation map.
provenance-mcp MCP server for the agent action-provenance log: append-only, ERC-191 signed, on-chain verifiable.
pumpfun-mcp Free read-only pump.fun and Solana MCP server: token discovery, curve and holder analysis, fee tracking, quotes.
pumpfun-skills pump.fun launch and trade skills as composable agent tools, with a runtime-supplied mint.
react React components for embedding three.ws 3D AI agents in two lines.
readme-3d Converts GLB, glTF, OBJ, and STL models into ASCII STL blocks GitHub renders as live 3D viewers in a README.
render Renders rigged, animated avatars to PNG, GIF, and truecolor terminal ANSI with no GPU, no WebGL, and no headless browser.
reputation SDK to read ERC-8004 agent trust scores and attest agent-to-agent feedback on-chain.
retarget Retargets animations onto any humanoid GLB by canonicalizing bone names across every major rig convention.
scene-mcp MCP server that turns one sentence into a placed 3D diorama over the live three.ws pipeline.
see Lets an agent see a 3D model: renders any GLB from several angles and returns frames it can look at, plus the geometry facts.
shipfeed Turns raw commit history into a release feed humans read: conventional-commit parsing, audience classification, and changelog-to-commit provenance.
sign-language American Sign Language for 3D avatars: compiles text into one continuous signed animation clip, fingerspelling what it does not know.
signals-mcp MCP server for copy-trade signal feeds: marketplace, publisher leaderboard, subscribe, and kill switch.
skill-license On-chain skill licenses: each purchased skill is a 1/1 SPL NFT plus a deterministic PDA.
spatial-mcp Validator, builder, and conformance fixtures for the Spatial MCP spec (live 3D scenes as MCP tool results).
strategies Automated on-chain trading strategies for agents: DCA, copy-trading, and mirror execution.
three-token-mcp MCP server that lets agents price, hold, and burn $THREE on-chain via the live token rail.
threews-avatar-mcp MCP server that renders a live rotatable avatar inline, plus embed iframe and metadata.
tool-sdk Typed tool authoring for three.ws MCP servers, with per-tool permission manifests.
tty-3d The terminal 3D renderer core: GLB in, skinned and animated ANSI frames out, plus the three-tty CLI.
tty-avatar A live 3D avatar in the terminal: any GLB or three.ws avatar/agent rendered to truecolor half-blocks or braille, with moods, and Claude Code hooks that make it your coding agent's face.
tutor-mcp MCP server for the Pay-As-You-Learn tutor ledger: itemized running tab and attested invoice.
vanity WASM-accelerated Solana vanity address mining in the browser or Node, with a paid x402 fallback.
vanity-mcp Read-only MCP server for the vanity grind-bounty market and proof-of-grind rarity gallery.
viewer-presets Tuned visual presets for avatar viewers: light rigs, floor reflection, bloom, and PBR materials.
vision-mcp MCP server that analyzes and describes images through the three.ws vision pipeline.
voice Speech for avatars: ASR, TTS, and Audio2Face lipsync visemes in one import.
vscode-3d VS Code extension that renders .glb and .gltf files in an editor tab, retargets library or text-described animations onto them and bakes the result, generates and refines models, optimizes and git-diffs them, AI quality-checks a render, and lint-checks <agent-3d> embeds with quick fixes.
vscode-x402 VS Code extension to browse the x402 bazaar, decode 402 challenges, and pay per call from the editor.
witness Records a real user session as intent, not pixels, and compiles it into a Playwright spec that stays red until the reported bug is fixed.
x402-fetch Drop-in fetch wrapper that automatically pays x402 payment challenges.
x402-mcp MCP server giving any agent a self-custodial x402 wallet: search the bazaar, inspect prices, pay and call.
x402-preflight Verifies a signed, time-bounded payability attestation from an x402 seller before you sign anything, and routes you to a rail that works.
x402-server The merchant side of x402: issue 402 challenges, price SKUs, verify and settle payments on Solana and Base.