Tychi Mcp

@yash@tychilabs

Visit Server

4 hours ago

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 Tools Comments

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

Architecture

What it does

Agent routing — tyi_route maps intent → correct tool (avoids slow misuse of tyi_chat)
Readiness gate — tyi_status checks mode before any wallet action
Onboarding — tyi_onboard + tyi_onboard_schema for 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_chat for 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_reset wipes 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`

License

Apache-2.0 — see LICENSE

Try in Playground

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"
      }
    }
  }
}

Build with ShipAny.