Tychi MCP (@tychilabs/tyi-mcp)

Audience: MCP host agents (OpenClaw, Claude Desktop, Cursor, Codex).
Not for humans. Human CLI: @tychilabs/tyi.

Self-custody wallet MCP. Keys in ~/.tyi. Brain at http://hosted_brain.tychilabs.com. Signing local only.

Mandatory flow

tyi_route → tyi_status
  → direct tool (create/import/switch/onboard/reset)   ← FAST, no brain
  → tyi_chat only for balance/send/policy              ← SLOW

Never call tyi_chat when tyi_status.ready is false.

Import additional wallet: collect seed/privkey from operator → tyi_import_wallet — never via tyi_chat.

Upcoming on Arbitrum One

Onchain DeFi for your agent wallet — same self-custody, same local signing, built for Arbitrum One:

| Coming | What it unlocks | |--------|-----------------| | Automation | Policy-gated agents that act onchain 24/7 — recurring sends, triggers, scheduled flows | | Trading | Spot swaps and routing across Arbitrum liquidity — agent quotes, you confirm, sign locally | | Lending | Supply assets on Arbitrum money markets — earn yield without leaving your keystore | | Borrowing | Collateralized borrow onchain — agent-assisted, cap-enforced, fully self-custodial |

Native Arbitrum execution. UGF gas routing today. Full DeFi stack next.

| Brain action | MCP tool | Status | |--------------|----------|--------| | import_wallet | tyi_import_wallet | done | | create_wallet | tyi_create_wallet | done | | switch_wallet | tyi_switch_wallet | done | | reveal_wallet | tyi_reveal_wallet | missing |

Tools

| Tool | When | |------|------| | tyi_route | First — intent → tool map | | tyi_create_wallet | User wants new wallet → not tyi_chat | | tyi_import_wallet | User wants import → not tyi_chat | | tyi_switch_wallet | Change active wallet → not tyi_chat | | tyi_onboard | First setup | | tyi_chat | Balance, send, pay, policy only |

Operator prompts (you ask human; never invent secrets)

| Field | Prompt | |-------|--------| | password | Keystore password for ~/.tyi → later TYI_PASSWORD in MCP env | | agent_name | Agent name (default Tychi) | | llm_provider | anthropic | gemini | openai | groq | | llm_api_key | Provider API key (validated, stored encrypted on brain) | | mnemonic | Optional import (fresh only) |

Prefer MCP env for TYI_PASSWORD over chat after onboard.

Modes (tyi_status.mode)

| Mode | Meaning | tyi_onboard needs | |------|---------|---------------------| | fresh | No wallet / incomplete | password, llm_provider, llm_api_key; optional agent_name, mnemonic | | llm_only | Wallet exists, no LLM vault | Same LLM fields + password | | ready | OK for chat | Do not onboard; use tyi_chat |

MCP host config

{
  "tychi": {
    "command": "npx",
    "args": ["-y", "@tychilabs/tyi-mcp@beta"],
    "env": {
      "TYI_PASSWORD": "<from tyi_onboard>",
      "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
    }
  }
}

OpenClaw set:

openclaw mcp set tychi '{"command":"npx","args":["-y","@tychilabs/tyi-mcp@beta"],"env":{"TYI_PASSWORD":"<password>","TYCHI_BRAIN_URL":"http://hosted_brain.tychilabs.com"}}'
openclaw mcp reload

Remove integration + data

1. tyi_reset with { "confirm": true } — wipes ~/.tyi
2. Remove TYI_PASSWORD from MCP env
3. OpenClaw: openclaw mcp unset tychi then openclaw mcp reload

Errors

| Symptom | Action | |---------|--------| | not_ready on chat | Run onboard flow | | TYI_PASSWORD env required | Set env after onboard; reload host | | no_llm_key / missing llm_key | tyi_onboard llm_only | | partial install | tyi_reset then fresh onboard | | fetch failed on brain | Use http:// not https:// for hosted brain |

Env

| Var | Required | Default | |-----|----------|---------| | TYI_PASSWORD | After onboard, for chat | — | | TYCHI_BRAIN_URL | No | http://hosted_brain.tychilabs.com | | TYI_DATA_DIR | No | ~/.tyi | | KEYSTORE_PASSWORD | Alias for TYI_PASSWORD | — |

Install

npx -y @tychilabs/tyi-mcp@beta
npx @tychilabs/tyi-mcp@beta --tools

License

Apache License 2.0 — see LICENSE. Runtime dependency: @tychilabs/tyi.