Skip to main content
Glama
Tychi Wallet MCP

Tychi Wallet MCP

Official
by TychiWallet

Tychi MCP (@tychilabs/tyi-mcp)

npm beta node mcp chain custody website license

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

Tychi agent wallet 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

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)              ← 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

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 --tools

Security

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 reload

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.

Prefer MCP env for TYI_PASSWORD over chat after onboard.

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)


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

Set TYCHI_BRAIN_URL explicitly; use HTTPS self-host or beta http://hosted_brain.tychilabs.com


Environment

Variable

Required

Default

TYI_PASSWORD

After onboard

—

TYCHI_BRAIN_URL

Recommended

http://hosted_brain.tychilabs.com (beta; prefer HTTPS override)

TYI_DATA_DIR

No

~/.tyi

KEYSTORE_PASSWORD

Alias

same as TYI_PASSWORD



License

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

Available Tools

9 tools
tyi_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

    A3.9/5.0

    Scored across 9 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Self-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.
      60
      29
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Agent-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.
      8
      Apache 2.0