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.

VerifiedSTDIODesktop onlyFinanceAI & ML

Overview

AI-generated 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.
Before you install
This is a beta wallet that can move real funds: sends and payments are signed locally and policy caps are the main safeguard. TYI_PASSWORD protects the keystore, and the LLM provider API key is stored encrypted on the hosted brain. Intent parsing and LLM calls go to the remote brain, whose default endpoint is plain HTTP, so set an HTTPS URL. Importing a mnemonic or private key exposes those secrets to the tool; tyi_reset wipes local data.

Installation

In SourceWeft

  1. Open Tychi MCP in the dashboard and add it to a workspace.
  2. 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_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.


Arbitrum One

Onchain agent wallet on Arbitrum One — self-custody, local signing, UGF gas routing today:

RoadmapWhat it unlocks
AutomationPolicy-gated agents — recurring sends, triggers, scheduled flows
TradingSpot swaps across Arbitrum liquidity — agent quotes, operator confirms
LendingSupply on Arbitrum money markets — yield without leaving keystore
BorrowingCollateralized 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

ToolUse when
tyi_routeFirst — intent → tool map
tyi_statusSession start — ready? what's missing?
tyi_onboard_schemaField schema before onboard
tyi_onboardFirst setup or LLM-only setup
tyi_create_walletNew wallet by name
tyi_import_walletImport mnemonic or privkey (EVM / Solana / Sui)
tyi_switch_walletChange active wallet
tyi_resetWipe ~/.tyi (confirm: true)
tyi_chatBalance, send, pay, transfer, policy, limits

Install

Pin the release (do not use floating @beta in production):

bash
npx @tychilabs/[email protected]npx @tychilabs/[email protected] --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).

json
{  "mcpServers": {    "tychi": {      "command": "npx",      "args": ["@tychilabs/[email protected]"],      "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:

bash
openclaw mcp set tychi '{"command":"npx","args":["@tychilabs/[email protected]"],"env":{"TYI_PASSWORD":"<password>","TYCHI_BRAIN_URL":"<https brain URL>"}}'openclaw mcp reload

Onboarding modes

ModeMeaning
freshNo wallet — run tyi_onboard
llm_onlyWallet exists, no LLM key — onboard LLM fields only
readyOK 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.

FieldPrompt
passwordKeystore password for ~/.tyi → later TYI_PASSWORD in MCP env
agent_nameAgent name (default Tychi)
llm_provideranthropic | gemini | openai | groq
llm_api_keyProvider API key (validated, stored encrypted on brain)
mnemonicOptional 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

SymptomAction
not_ready on chatRun onboard flow
TYI_PASSWORD env requiredSet env after onboard; reload host
no_llm_key / missing llm_keytyi_onboard llm_only
partial installtyi_reset then fresh onboard
fetch failed on brainSet TYCHI_BRAIN_URL explicitly; use HTTPS self-host or beta http://hosted_brain.tychilabs.com

Environment

VariableRequiredDefault
TYI_PASSWORDAfter onboard—
TYCHI_BRAIN_URLRecommendedhttp://hosted_brain.tychilabs.com (beta; prefer HTTPS override)
TYI_DATA_DIRNo~/.tyi
KEYSTORE_PASSWORDAliassame as TYI_PASSWORD

Links


License

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

Source: README.md at commit f8442bd

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  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