Tychi MCP

Agent-native self-custody wallet MCP: onboard, wallets, Arbitrum sends, policy-gated payments.

Que pouvez-vous faire avec Tychi MCP ?

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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @tychilabs/tyi-mcp

Claude Code

claude mcp add tychi-mcp -e 'TYI_PASSWORD=<your tyi_password>' -e 'TYCHI_BRAIN_URL=<TYCHI_BRAIN_URL>' -- npx -y @tychilabs/tyi-mcp@1.0.0-beta.8

Configuration JSON (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "tychi-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@tychilabs/tyi-mcp@1.0.0-beta.8"
            ],
            "env": {
                "TYI_PASSWORD": "<your tyi_password>",
                "TYCHI_BRAIN_URL": "<TYCHI_BRAIN_URL>"
            }
        }
    }
}

Variables d'environnement

TYI_PASSWORD obligatoire secret Keystore password for ~/.tyi (set after tyi_onboard)
TYCHI_BRAIN_URL Tychi brain API URL (HTTPS recommended)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire

Tychi MCP (@tychilabs/tyi-mcp)
What it does
Arbitrum One
Agent flow (mandatory)
Tools
Install
Security
MCP host config
Onboarding modes
Remove integration + data
Errors
Environment
Links
License

Tychi MCP (`@tychilabs/tyi-mcp`)

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

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:

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

tyi_reset with { "confirm": true } — wipes ~/.tyi
Remove TYI_PASSWORD from MCP env
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.

Questions fréquentes

Qu'est-ce que Tychi MCP ?

Agent-native self-custody wallet MCP: onboard, wallets, Arbitrum sends, policy-gated payments.

Comment installer Tychi MCP ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add tychi-mcp -e 'TYI_PASSWORD=<your tyi_password>' -e 'TYCHI_BRAIN_URL=<TYCHI_BRAIN_URL>' -- npx -y @tychilabs/tyi-mcp@1.0.0-beta.8. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Tychi MCP ?

Oui. Il attend TYI_PASSWORD, à renseigner dans sa configuration.

Tychi MCP est-il open source ?

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient Tychi MCP ?

Il est publié par TychiWallet. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.

Détails du serveur

Référencé dans: Registre MCP officiel
Éditeur: TychiWallet
Catégorie: Finance et paiements
Exécution: Local
Étoiles GitHub: ★ 3
Licence: Apache-2.0
Langage: TypeScript
Dernier commit: 15 juin 2026
Tickets ouverts: 0
Version: 1.0.0-beta.8
Publié le: 15 juin 2026

io.github.TychiWallet/tyi-mcp

Serveurs similaires

Backbone Manage your back office: invoices, reminders, receipts and time tracking in Germany and...
ARKOSCOPE Public Sources Read-only, dated public crypto source registry with evidence status. Local stdio; no AP...
Delegance Commercial Insurance Your company's commercial insurance: policies, coverage, certificates, quotes and claims.
Eclipse Beacon MCP The insurance watcher — signals your policies' expiries before they happen. It does not...
PuppyMacro Auto clicker, macros and hotkeys for PC. AI-ready. Needs the PuppyMacro app installed.
ZKStamp Proof-100 Shielded proof-of-existence timestamps on the BitcoinZ blockchain (zk-SNARKs).
TradeHub Perpetual futures trading for AI agents on the user's own exchange accounts, behind one...
Cuéntamo Household and freelance finances (Spain): balance forecast, spending, transactions, VAT...

Finance et paiements