Tychi Wallet MCP
OfficialTychi Wallet MCP gives your AI agent a self-custodial wallet on Arbitrum One, with local signing that never leaves your device. Key capabilities:
Intent routing (
tyi_route): Maps agent intent to the correct tool first, preventing misuse oftyi_chat.Readiness check (
tyi_status): Inspects session state at startup before any wallet operations.Onboarding (
tyi_onboard+tyi_onboard_schema): First-time setup for keystore password, agent name, LLM provider (Anthropic, Gemini, OpenAI, or Groq), API key, and optional mnemonic import.Wallet lifecycle: Create new wallets (
tyi_create_wallet), import from BIP39 mnemonic or private key for EVM/Solana/Sui (tyi_import_wallet), and switch active wallet by name (tyi_switch_wallet).Agent chat for financial ops (
tyi_chat): Check balances, send/transfer funds, make policy-gated payments, query spend limits, and view transaction history — processed through the hosted Tychi brain LLM.Secure local signing: Private keys are encrypted in
~/.tyi; signing never leaves the operator's machine.Policy-enforced spending: Spend caps are checked before any transaction is signed.
Gasless payments: UGF payment rails handle gas settlement on Arbitrum One (chain id 42161).
Audit logging: Local activity trail maintained in
~/.tyi.Data reset (
tyi_reset): Wipes all local data in~/.tyiwhen explicitly confirmed.
Enables AI agents to use OpenAI's LLM for wallet-related chat operations such as balance inquiries, transactions, and policy management.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Tychi Wallet MCP what's my ETH balance on Arbitrum?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Tychi MCP (@tychilabs/tyi-mcp)
Give your AI agent a wallet — onboard, hold funds, send, and pay under policy.
Agent-native MCP server (stdio) for Cursor and other hosts. Nine tools: routing (tyi_route), readiness (tyi_status), onboarding, fast wallet lifecycle (create / import / switch), and tyi_chat for balances, sends, and policy-gated payments on Arbitrum One. Private keys encrypted in ~/.tyi on the operator machine; signing never leaves the device. Hosted Tychi brain parses intent and runs the LLM — configure TYCHI_BRAIN_URL (HTTPS recommended; see SECURITY.md).
Agents → @tychilabs/tyi-mcp@1.0.0-beta.8 · Humans → @tychilabs/tyi

What it does
Agent routing —
tyi_routemaps intent → correct tool (avoids slow misuse oftyi_chat)Readiness gate —
tyi_statuschecks mode before any wallet actionOnboarding —
tyi_onboard+tyi_onboard_schemafor first-time setup (password, LLM provider, API key)Wallet lifecycle —
tyi_create_wallet,tyi_import_wallet,tyi_switch_wallet(fast, no brain loop)Agent chat —
tyi_chatfor balances, sends, transfers, payments, policy, limits, historyMulti-wallet — create, import, switch active wallet from one keystore
Policy caps — spend limits enforced before signing
Local signing — private keys in memory on operator machine only
Gasless routing — UGF payment rails for cross-chain gas settlement
Audit log — local activity trail in
~/.tyiReset —
tyi_resetwipes local data when operator confirms
Beta ships on Arbitrum One (chain id 42161) — EVM balances, sends, and UGF gasless payments. More chains in registry; Solana/Sui import supported.
Related MCP server: seashail
Arbitrum One
Onchain agent wallet on Arbitrum One — self-custody, local signing, UGF gas routing today:
Roadmap | What it unlocks |
Automation | Policy-gated agents — recurring sends, triggers, scheduled flows |
Trading | Spot swaps across Arbitrum liquidity — agent quotes, operator confirms |
Lending | Supply on Arbitrum money markets — yield without leaving keystore |
Borrowing | Collateralized borrow — cap-enforced, fully self-custodial |
Agent flow (mandatory)
tyi_route → tyi_status
→ direct tool (onboard / create / import / switch / reset) ← FAST
→ tyi_chat (balance / send / pay / policy only) ← SLOWNever call tyi_chat when tyi_status.ready is false.
Import seed or private key → tyi_import_wallet only (never via tyi_chat).
Tools
Tool | Use when |
| First — intent → tool map |
| Session start — ready? what's missing? |
| Field schema before onboard |
| First setup or LLM-only setup |
| New wallet by name |
| Import mnemonic or privkey (EVM / Solana / Sui) |
| Change active wallet |
| Wipe |
| Balance, send, pay, transfer, policy, limits |
Install
Pin the release (do not use floating @beta in production):
npx @tychilabs/tyi-mcp@1.0.0-beta.8
npx @tychilabs/tyi-mcp@1.0.0-beta.8 --toolsSecurity
See SECURITY.md — trust model, brain transport (HTTP beta endpoint), sensitive tools, supply-chain pinning. No install scripts.
MCP host config
Repo includes .mcp.json (Open Plugins) for Cursor Directory. Set TYI_PASSWORD and TYCHI_BRAIN_URL in host env (HTTPS brain recommended).
{
"mcpServers": {
"tychi": {
"command": "npx",
"args": ["@tychilabs/tyi-mcp@1.0.0-beta.8"],
"env": {
"TYI_PASSWORD": "<from tyi_onboard>",
"TYCHI_BRAIN_URL": "<https brain URL — required>"
}
}
}
}Beta default if unset in code: http://hosted_brain.tychilabs.com — use HTTPS self-host or trusted network only.
OpenClaw:
openclaw mcp set tychi '{"command":"npx","args":["@tychilabs/tyi-mcp@1.0.0-beta.8"],"env":{"TYI_PASSWORD":"<password>","TYCHI_BRAIN_URL":"<https brain URL>"}}'
openclaw mcp reloadOnboarding modes
Mode | Meaning |
| No wallet — run |
| Wallet exists, no LLM key — onboard LLM fields only |
| OK for |
Operator provides (never invent): keystore password, LLM provider + API key, optional mnemonic for import.
Prefer MCP env for TYI_PASSWORD over chat after onboard.
Field | Prompt |
| Keystore password for |
| Agent name (default |
|
|
| Provider API key (validated, stored encrypted on brain) |
| Optional import (fresh only) |
Remove integration + data
tyi_resetwith{ "confirm": true }— wipes~/.tyiRemove
TYI_PASSWORDfrom MCP envOpenClaw:
openclaw mcp unset tychithenopenclaw mcp reload
Errors
Symptom | Action |
| Run onboard flow |
| Set env after onboard; reload host |
|
|
|
|
| Set |
Environment
Variable | Required | Default |
| After onboard | — |
| Recommended |
|
| No |
|
| Alias | same as |
Links
Website: https://tychilabs.com
Human CLI: https://www.npmjs.com/package/@tychilabs/tyi
License
Apache License 2.0 — see LICENSE. Runtime dependency: @tychilabs/tyi.
Available Tools
9 toolstyi_chatA
SLOW brain agent. ONLY: balance, send, pay, transfer, policy, limits, history, general Q. NEVER: create wallet, import, onboard, reset, switch — use dedicated tyi_* tools instead.
Inputs: message (required), reset.
tyi_create_walletA
FAST. New wallet by name. User said create/new wallet → call this NOT tyi_chat.
Inputs: name (required), label.
tyi_import_walletA
FAST. Import seed/privkey. User said import/restore → call this NOT tyi_chat. Secret via tool param only.
Inputs: name (required), kind (required), secret (required), label.
tyi_onboardB
FAST. First-time setup only. NOT tyi_chat.
Inputs: password (required), llm_provider (required), llm_api_key (required), agent_name, +1 more.
tyi_onboard_schemaB
Onboarding field schema. Use with tyi_onboard — not tyi_chat.
Inputs: no named parameters.
tyi_resetA
Wipe ~/.tyi. confirm:true required. NOT tyi_chat.
Inputs: confirm (required).
tyi_routeA
READ FIRST. Intent → tool map. Call before any wallet op. Prevents slow tyi_chat misuse.
Inputs: no named parameters.
tyi_statusA
Check ready + missing. Call once at session start.
Inputs: no named parameters.
tyi_switch_walletA
FAST. Set active wallet by name. NOT tyi_chat.
Inputs: name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose, with explicit instructions on when to use each and when NOT to use tyi_chat. The tyi_route tool further aids in disambiguation by mapping intents to tools.
All tools follow a consistent tyi_ prefix with snake_case naming. Most use a verb_noun pattern (e.g., tyi_create_wallet, tyi_import_wallet), with a few noun-only names (tyi_chat, tyi_status, tyi_route) that are still predictable and uniform.
9 tools is well-scoped for a wallet management server. Each tool serves a distinct function (onboarding, wallet creation/import/switch, reset, status, chat, routing), and there is no redundancy or unnecessary bloat.
The tool surface covers core wallet operations: onboarding, creation, import, switch, reset, status, and general queries via chat. While transactional actions like send/pay are handled through tyi_chat rather than dedicated tools, the surface is still complete for the domain.
Maintenance
Related MCP Connectors
MCP server for the Z1N Protocol - on-chain identity for AI agents on Polygon
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
Self-hosted MCP server: 26 deterministic dev, security, and EVM tools.
Hosted MCP server for live Bittensor chain reads and self-custodial on-chain writes.
Related MCP Servers
- AlicenseCqualityDmaintenanceSelf-hosted wallet MCP server for AI agents. Provides 42 tools for multi-chain crypto operations: transfers, token management, DeFi (swap, lend, stake, bridge, perp), NFT, smart contracts, and x402 payments. Supports EVM and Solana with policy engine, spending limits, and human approval.6029MIT
- AlicenseNot gradedqualityDmaintenanceAgent-native, self-hosted MCP server for crypto trading and DeFi management. Enables agents to query balances, execute trades, and manage positions with a policy engine and secure key storage.8Apache 2.0
- AlicenseNot gradedqualityCmaintenanceSelf-hosted MCP server enabling AI agents to manage EVM wallets, check balances, swap tokens, and securely execute transactions via 1Claw Intents without exposing private keys.100 PyPIMIT
- FlicenseNot gradedqualityBmaintenanceA zero-dependency MCP server that bridges AI agents to Robinhood Chain and Arbitrum Orbit L2 networks, enabling querying balances, simulating transactions, and signing/broadcasting EVM transactions via JSON-RPC tools.6-