
Tychi MCP
io.github.TychiWalletPublished by GitHub account TychiWalletv1.0.0-beta.8Updated Nov 10, 2026
Agent-native self-custody wallet MCP: onboard, wallets, Arbitrum sends, policy-gated payments.
Overview
Gives an AI agent a self-custody crypto wallet on Arbitrum One: onboarding, wallet management, balances, sends and policy-capped payments.
- What you can do
- Route intents to the right tool and check readiness before wallet actions
- Onboard the agent and manage wallets: create, import a mnemonic or private key, switch the active wallet, reset local data
- Chat-style operations for balances, sends, transfers, payments, policy and limits
- Enforce spend caps before signing, with keys kept in a local keystore and an audit trail
- When to use it
- Use it when you want an assistant to hold and move funds on Arbitrum One under operator-defined spend limits, or to set up and manage a local agent wallet from a desktop MCP host such as Cursor.
- Requirements
- Runs locally via npx (Node.js) over stdio; desktop host only. Needs TYCHI_BRAIN_URL pointing at the hosted brain (HTTPS recommended) and, after onboarding, the TYI_PASSWORD keystore password in the host environment. Onboarding also asks for an LLM provider and its API key, and optionally a mnemonic for import.
Installation
In SourceWeft
- Open Tychi MCP in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
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/[email protected] · Humans → @tychilabs/tyi
[Tychi agent wallet architecture]
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
Beta ships on Arbitrum One (chain id 42161) — EVM balances, sends, and UGF gasless payments. More chains in registry; Solana/Sui import supported.
Arbitrum One
Onchain agent wallet on Arbitrum One — self-custody, local signing, UGF gas routing today:
Agent flow (mandatory)
Never call tyi_chat when tyi_status.ready is false.
Import seed or private key → tyi_import_wallet only (never via tyi_chat).
Tools
Install
Pin the release (do not use floating @beta in production):
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).
Beta default if unset in code: http://hosted_brain.tychilabs.com — use HTTPS self-host or trusted network only.
OpenClaw:
Onboarding modes
Operator provides (never invent): keystore password, LLM provider + API key, optional mnemonic for import.
Prefer MCP env for TYI_PASSWORD over chat after onboard.
Remove integration + data
tyi_resetwith{ "confirm": true }— wipes~/.tyi- Remove
TYI_PASSWORDfrom MCP env - OpenClaw:
openclaw mcp unset tychithenopenclaw mcp reload
Errors
Environment
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 License 2.0 — see LICENSE. Runtime dependency: @tychilabs/tyi.
Source: README.md at commit f8442bd
Tools
0Version history
1- v1.0.0-beta.8LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts