claude mcp add oculusmind \
  --env OCULUSMIND_TOKEN= \
  -- npx -y @oculusmind-ai/mcp-server

# npm install also builds the in-repo A2A client this depends on
cd servers/mcp && npm install && npm run build

claude mcp add oculusmind \
  --env OCULUSMIND_TOKEN= \
  -- node "$(pwd)/dist/index.js"

import { OculusMindAgents, StaticTokenProvider } from '@oculusmind-ai/agents';

const client = new OculusMindAgents({
  agent: 'vera', // or 'uno' | 'maximus'
  tokenProvider: new StaticTokenProvider(process.env.OCULUSMIND_TOKEN!),
});
const reply = await client.send('What is the weather in Austin?');
console.log(reply.text);

from oculusmind_ai_agents import OculusMindAgents, StaticTokenProvider

client = OculusMindAgents(
    agent="vera",  # or "uno" | "maximus"
    token_provider=StaticTokenProvider(os.environ["OCULUSMIND_TOKEN"]),
)
print(client.send("What is the weather in Austin?").text)

├── servers/
│   └── mcp/               MCP server for Claude Code & other MCP hosts
├── clients/
│   ├── typescript/        A2A client library (@oculusmind-ai/agents)
│   └── python/            A2A client library (oculusmind-ai-agents)
│                          The MCP server consumes the TypeScript client
│                          directly from this repo — one A2A implementation,
│                          not two. Wired as an npm workspace; nothing is
│                          fetched from a private registry.
├── docs/
│   ├── AUTHENTICATION.md  how to get a token + the refresh best-practice
│   ├── PROTOCOL.md        the A2A wire contract both speak
│   └── ROADMAP.md         languages, token auto-refresh
├── examples/              runnable samples
└── LICENSE · NOTICE

npm install
npm run check              # build + lint + typecheck + format + unit tests
npm run test:integration   # spawns the built MCP server over stdio

# Live tests against production are opt-in; without a token they self-skip.
OCULUSMIND_TOKEN= npm run test:integration