Tychi Mcp
@yash@tychilabs
Give your AI agent a wallet it can actually use. Tychi MCP plugs into Cursor, Claude Desktop, OpenClaw, and any stdio MCP host — onboard, create, import, and switch wallets with fast direct tools, then balance checks, sends, and policy-gated payments through tyi_chat. Keys live encrypted in ~/.tyi on the operator's machine; a hosted brain parses intent and routes LLM calls while every signature stays local. Includes routing guide (tyi_route), readiness checks (tyi_status), multi-wallet support, spend caps, audit logging, and gasless payment routing via UGF. Built for agent workflows: secrets via tool params or env, never through chat. Apache-2.0, npm + GitHub.
Overview
Tychi MCP
Give your AI agent a wallet — onboard, hold funds, send, and pay under policy.
Agent-native MCP server for stdio hosts. Fast direct tools for wallet setup and ops; tyi_chat for balance, sends, and policy-gated payments. Keys encrypted in ~/.tyi on the operator's machine. Hosted brain parses intent and routes LLM — signing never leaves the device.
Agents → @tychilabs/tyi-mcp · 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 action - Onboarding —
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, history - Multi-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
~/.tyi - Reset —
tyi_resetwipes local data when operator confirms
Agent flow (mandatory)
tyi_route → tyi_status
→ direct tool (onboard / create / import / switch / reset) ← FAST
→ tyi_chat (balance / send / pay / policy only) ← SLOW
Never 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 |
|---|---|
tyi_route | First — intent → tool map |
tyi_status | Session start — ready? what's missing? |
tyi_onboard_schema | Field schema before onboard |
tyi_onboard | First setup or LLM-only setup |
tyi_create_wallet | New wallet by name |
tyi_import_wallet | Import mnemonic or privkey (EVM / Solana / Sui) |
tyi_switch_wallet | Change active wallet |
tyi_reset | Wipe ~/.tyi (confirm: true) |
tyi_chat | Balance, send, pay, transfer, policy, limits |
Install
npx -y @tychilabs/tyi-mcp@beta
npx @tychilabs/tyi-mcp@beta --tools
MCP host config
{
"mcpServers": {
"tychi": {
"command": "npx",
"args": ["-y", "@tychilabs/tyi-mcp@beta"],
"env": {
"TYI_PASSWORD": "<from tyi_onboard>",
"TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
}
}
}
}
Onboarding modes
| Mode | Meaning |
|---|---|
fresh | No wallet — run tyi_onboard |
llm_only | Wallet exists, no LLM key — onboard LLM fields only |
ready | OK for tyi_chat |
Operator provides (never invent): keystore password, LLM provider + API key, optional mnemonic for import.
Set TYI_PASSWORD in MCP host env after onboard — not in chat.
Environment
| Variable | Required | Default |
|---|---|---|
TYI_PASSWORD | After onboard | — |
TYCHI_BRAIN_URL | No | http://hosted_brain.tychilabs.com |
TYI_DATA_DIR | No | ~/.tyi |
KEYSTORE_PASSWORD | Alias | same as TYI_PASSWORD |
Links
- Website: https://tychilabs.com
- npm: https://www.npmjs.com/package/@tychilabs/tyi-mcp
- GitHub: https://github.com/TychiWallet/tyi-mcp
- Human CLI: https://www.npmjs.com/package/@tychilabs/tyi
License
Apache-2.0 — see LICENSE
Server Config
{
"mcpServers": {
"tychi": {
"command": "npx",
"args": [
"-y",
"@tychilabs/tyi-mcp@beta"
],
"env": {
"TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
"TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
}
}
}
}