Tychi Mcp

Created By

yash@tychilabs5 days 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.

# wallet

# mcp

Overview Content Tools Comments

Content

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

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

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

Serper MCP ServerA Serper MCP Server

RedisA Model Context Protocol server that provides access to Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

Amap Maps高德地图官方 MCP Server

Y GuiA web-based graphical interface for AI chat interactions with support for multiple AI models and MCP (Model Context Protocol) servers.

DeepChatYour AI Partner on Desktop