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
// Tool-surface invariants for @three-ws/brain-mcp.
//
// Importing src/index.js is side-effect-free: the stdio transport only
// connects when the file is the process entry point, and buildServer() needs
// no key or signer. These tests run offline — they never touch the network.
//
// Run: node --test packages/brain-mcp/test/registration.test.mjs
import { test } from 'node:test';
import assert from 'node:assert/strict';
import { TOOLS, buildServer } from '../src/index.js';
const EXPECTED_NAMES = ['list_providers', 'chat'];
test('exactly the expected tools are registered', () => {
assert.equal(TOOLS.length, 2);
assert.deepEqual(new Set(TOOLS.map((t) => t.name)), new Set(EXPECTED_NAMES));
});
test('every tool has a title, description, input schema and complete annotations', () => {
for (const tool of TOOLS) {
assert.equal(typeof tool.title, 'string', `${tool.name} is missing a title`);
assert.ok(tool.title.length > 0, `${tool.name} has an empty title`);
assert.equal(typeof tool.description, 'string', `${tool.name} is missing a description`);
assert.ok(tool.description.length > 0, `${tool.name} has an empty description`);
assert.ok(tool.inputSchema && typeof tool.inputSchema === 'object', `${tool.name} is missing inputSchema`);
assert.equal(typeof tool.handler, 'function', `${tool.name} is missing a handler`);
assert.ok(tool.annotations, `${tool.name} is missing MCP ToolAnnotations`);
assert.equal(typeof tool.annotations.readOnlyHint, 'boolean', `${tool.name} must set readOnlyHint`);
assert.equal(typeof tool.annotations.idempotentHint, 'boolean', `${tool.name} must set idempotentHint`);
assert.equal(typeof tool.annotations.openWorldHint, 'boolean', `${tool.name} must set openWorldHint`);
}
});
test('every tool is a read-only, live-data query', () => {
for (const tool of TOOLS) {
assert.equal(tool.annotations.readOnlyHint, true, `${tool.name} should be read-only`);
assert.equal(tool.annotations.openWorldHint, true, `${tool.name} talks to a live service`);
// A completion is non-deterministic and the provider set moves between
// calls — neither tool is idempotent.
assert.equal(tool.annotations.idempotentHint, false, `${tool.name} is not idempotent`);
}
});
test('read-only tools set destructiveHint: false explicitly (a read is never destructive)', () => {
for (const tool of TOOLS) {
assert.equal(
tool.annotations.destructiveHint,
false,
`${tool.name} is read-only, so destructiveHint must be an explicit false`,
);
}
});
test('buildServer registers every tool with its annotations, without a signer', () => {
const server = buildServer();
const registered = server._registeredTools;
assert.ok(registered, 'McpServer should expose its tool registry');
for (const tool of TOOLS) {
const entry = registered[tool.name];
assert.ok(entry, `${tool.name} not registered on the server`);
assert.deepEqual(entry.annotations, tool.annotations, `${tool.name} annotations must survive registration`);
}
});