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.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
import Ajv from 'ajv';
import addFormats from 'ajv-formats';
import { buildGettingStartedTool } from '../_lib/mcp-getting-started.js';
import { toolDefs as walletToolDefs } from './tools.js';
import { marketplaceToolDefs } from './marketplace-tools.js';
import { predictionToolDefs } from './predictions-tools.js';
import { orderToolDefs } from './orders-tools.js';
import { perpsToolDefs } from './perps-tools.js';
import { papertradeToolDefs } from './papertrade-tools.js';
import { tradingToolDefs } from './trading-tools.js';
import { portfolioToolDefs } from './portfolio-tools.js';
import { sniperAlertToolDefs } from './sniper-alert-tools.js';
import { duelToolDefs } from './duels-tools.js';
import { commerceToolDefs } from './commerce-tools.js';
import { eventMarketToolDefs } from './event-markets-tools.js';
import { eventMarketForecastToolDefs } from './event-market-forecast-tools.js';
import { namedServiceToolDefs } from './named-services-tools.js';
const toolDefs = [...walletToolDefs, ...marketplaceToolDefs, ...predictionToolDefs, ...perpsToolDefs, ...papertradeToolDefs, ...tradingToolDefs,
...portfolioToolDefs, ...sniperAlertToolDefs, ...duelToolDefs, ...commerceToolDefs, ...orderToolDefs, ...eventMarketToolDefs, ...eventMarketForecastToolDefs,
...namedServiceToolDefs];
// Free, public entry point, listed first so discovery clients see it up top.
// Annotations: a static, local overview built at module load: read-only,
// deterministic, closed-world (destructiveHint is explicit because the MCP
// spec defaults it to true when omitted).
const gettingStarted = {
...buildGettingStartedTool({
server: 'three.ws Agent',
tagline: 'Give your assistant a real on-chain wallet to discover, pay for, and call x402 services in USDC.',
tools: toolDefs,
access: [
'Sign in with your three.ws account (OAuth) to use your agent wallet.',
'pay_and_call spends USDC from your own three.ws agent wallet within your spend caps. Check wallet_status first.',
],
links: { homepage: 'https://three.ws', source: 'https://github.com/nirholas/three.ws' },
}),
annotations: {
readOnlyHint: true,
destructiveHint: false,
idempotentHint: true,
openWorldHint: false,
},
};
const allDefs = [gettingStarted, ...toolDefs];
// Schema objects for tools/list; strip internal fields (scope, handler). The
// tool-policy fields (docs/prompts/03: group, tier, confirmFlag, previewTool)
// travel under _meta so clients can read which calls move funds and what must
// run first, without polluting the MCP tool shape.
export const TOOL_CATALOG = allDefs.map(({ scope: _s, handler: _h, group, tier, confirmFlag, previewTool, ...schema }) =>
group
? {
...schema,
_meta: {
'three.ws/policy': {
group,
tier,
...(confirmFlag ? { confirm_flag: confirmFlag } : {}),
...(previewTool ? { preview_tool: previewTool } : {}),
},
},
}
: schema,
);
const ajv = new Ajv({ allErrors: true, useDefaults: true, coerceTypes: true, strict: false });
addFormats(ajv);
export const TOOLS = Object.fromEntries(
allDefs.map(({ name, scope, handler, inputSchema }) => [
name,
{ scope, handler, validate: inputSchema ? ajv.compile(inputSchema) : null },
]),
);