@t2000/cli + @t2000/mcp + t2000-skills — one CLI, one MCP server, one skill set. It’s the command surface for the whole stack, not just a wallet:
- Money (the core) — hold + send USDC/USDsui gasless, swap any Sui token, pay any API per call over x402 (
t2 send · swap · pay) - Identity — register an Agent ID, claim a handle, look up the directory (
t2 agent …·t2 agents) - Inference — Private Inference, including trustless receipt verification (
t2 chat · models · verify)
t2 <verb>, everything --json-scriptable); the MCP server is the AI-client surface — the same money, identity, and inference capabilities as tools (raising spending limits stays CLI-only by design); skills are the orchestration playbooks both share.
Install
--json for machine-parseable output and --key <path> for a non-default wallet file.
Commands
The core loop is four commands:| Command | What it does |
|---|---|
t2 init | Create the wallet + a free on-chain Agent ID. --import brings an existing secret. |
t2 fund | The wallet address + QR — send USDC to it and you’re live. |
t2 send <amount> <asset> <recipient> | Send USDC / USDsui (gasless) or SUI. Recipient: 0x…, SuiNS name, or @audric handle. |
t2 pay <url> | Pay an x402-protected API — 402 challenge → USDC payment → response, automatically. |
Gasless
USDC + USDsui sends and x402pay are gasless — the Sui foundation sponsors the protocol-level 0x2::balance::send_funds flow. SUI sends and Cetus swaps need gas; keep ~0.05 SUI on hand. Any Sui exchange or DEX will fund the gas balance.
Examples
Configuration
| Path | Purpose |
|---|---|
~/.t2000/wallet.key | Plain JSON wallet — { version: 2, secret: "suiprivkey1…" }, 0o600 perms. |
~/.t2000/config.json | Spending limits + daily usage (seeded at t2 init: $25/tx · $100/day; t2 limit reset clears). |
| Env var | Effect |
|---|---|
T2000_RPC_URL | Legacy alias of T2000_GRPC_URL — resolves a custom Sui gRPC base URL (JSON-RPC is retired). |
T2000_GRPC_URL | Custom Sui gRPC endpoint (defaults to fullnode.mainnet.sui.io). Used during gasless USDC/USDsui send + pay builds. |
T2000_GATEWAY_URL | Override the x402 gateway URL for t2 services + t2 pay. Defaults to https://mpp.t2000.ai. |
MCP Integration
The CLI ships with the t2000 MCP stdio server.t2 mcp install writes the right JSON config for every supported AI client on your machine.
| Client | Setup | Config path |
|---|---|---|
| Claude Desktop | t2 mcp install | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Cursor | t2 mcp install | ~/.cursor/mcp.json |
| Windsurf | t2 mcp install | ~/.codeium/windsurf/mcp_config.json |
| Codex / Cline / Continue / any MCP client | Manual JSON (below) | client-specific |
t2 command must be on PATH — npm install -g @t2000/cli puts it there. The env block is only needed for the inference tools (t2000_chat / t2000_models) — every wallet tool works without it. Get a key per Authentication; after t2 mcp install, add the env block to the generated entry by hand.
MCP Tools
| Tool | Type | What it does |
|---|---|---|
t2000_balance | read | USDC / USDsui / SUI holdings + gas reserve + USD totals. |
t2000_address | read | Wallet’s Sui address. |
t2000_receive | read | Payment request — address, Payment Kit sui:pay?… URI, optional amount / memo / label. |
t2000_history | read | Recent on-chain activity with Suiscan digests. |
t2000_services | read | Discover x402 services on mpp.t2000.ai. Call before t2000_pay. |
t2000_agents | read | Look up registered on-chain Agent IDs in the directory. |
t2000_send | write | Send USDC / USDsui / SUI. asset is required. USDC + USDsui gasless. dryRun: true for previews. |
t2000_swap | write | Cetus Aggregator V3 swap. Requires SUI for gas. |
t2000_pay | write | Pay an x402-protected API. HTTP 402 → quote → USDC payment (gasless) → retry. |
t2000_chat | read | Private inference on Private Inference (OpenAI-compatible). Needs T2000_API_KEY in the server env. |
t2000_models | read | List Private Inference model catalog (id · privacy tier · pricing). |
t2000_verify | read | Verify a confidential response by receipt id — signed receipt + trustless on-chain Sui anchor. No key required. |
t2000_limit | settings | Read-only. Surface the user’s opt-in caps to the LLM. Setting / clearing flows through CLI (security boundary). |
skill-<name> MCP prompt — one per SKILL.md, including the Sui ecosystem skills (SuiNS · Walrus · DeepBook · Sui gRPC).
Security
- Wallet file is
0o600— owner read/write only. stdio transport, keys never leave the machine. - Every write tool has a
dryRun: truepreview path. - Setting / clearing spending caps requires CLI terminal access (the
t2000_limittool is read-only).
Skills
Skills are markdown instruction files your agent reads on demand — decision frameworks, correct patterns, common mistakes. Install per-client:| Skill | What it teaches |
|---|---|
t2000-setup | End-to-end wallet bootstrap (t2 init + optional limits + MCP install). Read first when onboarding a new user. |
t2000-check-balance | Inspect USDC / USDsui / SUI before any write. |
t2000-send | Explicit --asset, gasless USDC / USDsui, SUI sends that need gas. |
t2000-receive | Address share, ANSI QR, Payment Kit sui:pay?… URIs. |
t2000-swap | Cetus Aggregator routing, --quote, slippage, swap-needs-SUI gotcha. |
t2000-services | Discover x402 services before t2 pay. |
t2000-pay | x402 402 → quote → pay → retry flow. |
t2000-verify | Verify a confidential response — t2 verify <receipt> or verify.t2000.ai. |
t2000-mcp | Wire the MCP server into Claude / Cursor / Windsurf. |
sui-grpc · suins · deepbook · walrus | Sui ecosystem reads — chain state over gRPC, name resolution, order-book data, blob storage. Browse by project at agents.t2000.ai. |
https://t2000.ai/skills/<slug> — curl it or open in a browser. The discovery manifest lives at /.well-known/agent-skills/index.json.
Skills + MCP are complementary: skills give the agent context that doesn’t change often (workflows, patterns, gotchas). The MCP server gives it the tools that do change (live balances, fresh quotes, current chain state).
At a glance
| Surface | Detail |
|---|---|
| Wallet file | Plain Bech32 JSON at ~/.t2000/wallet.key, 0o600 perms |
| Sendable assets | USDC, USDsui, SUI (asset required on every send) |
| Gasless | USDC + USDsui via Sui foundation’s 0x2::balance::send_funds sponsor |
| Spending limits | On by default ($25/tx · $100/day); t2 limit set to adjust; gates CLI and MCP writes |
| MCP tools | The table above is canonical — read, write, and settings groups |
| Skills | One markdown playbook per task, shipped as skill-<name> MCP prompts |
| Fees | Free at the t2000 layer. Network gas + third-party protocol fees still apply. |
@t2000/sdk.
Programmatic usage
For TypeScript programmatic access — building bots, server apps, or your own consumer surface — use@t2000/sdk:
