Tychi MCP

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

ماذا يمكنك أن تفعل مع 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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

إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

TYI_PASSWORD إلزامي سري Keystore password for ~/.tyi (set after tyi_onboard)
TYCHI_BRAIN_URL Tychi brain API URL (HTTPS recommended)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات

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.

الأسئلة الشائعة

ما هو Tychi MCP؟

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

كيف أثبّت Tychi 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Tychi MCP إلى مفتاح API؟

نعم. يتطلب TYI_PASSWORD، وتضبطها في إعداداته.

هل Tychi MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون Tychi MCP؟

ينشره TychiWallet. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.

تفاصيل الخادم

مُدرج في: سجل MCP الرسمي
الناشر: TychiWallet
الفئة: المالية والمدفوعات
طريقة التشغيل: محلي
نجوم GitHub: ★ 3
الترخيص: Apache-2.0
لغة البرمجة: TypeScript
آخر تحديث للشيفرة: ١٥‏/٠٦‏/٢٠٢٦
المشكلات المفتوحة: 0
الإصدار: 1.0.0-beta.8
نُشر في: ١٥‏/٠٦‏/٢٠٢٦

io.github.TychiWallet/tyi-mcp

خوادم مشابهة

BananaSplit Track shared expenses, payments and balances across BananaSplit groups and friends.
LeaseCommand Lease records and ASC 842 lease accounting data with confirmed write operations.
ofdkit Read OFD files and Chinese e-invoices (数电票): text, invoice fields, folder totals. Re...
Moneda Financial intelligence for AI: manage balances, transactions, payments, and more
Verify MCP (AgentBook verification) Verify AgentBook registration and operator attestations for agent wallets on World Chain.
easySales Sales and billing for small businesses: leads, quotations, invoices, receipts and credi...
EU e-invoicing and business checks (EN 16931, Peppol, VAT, sanctions) EN 16931/XRechnung e-invoice validate+create, Peppol routing, EU VAT/EORI, sanctions, K...
Kaal Agent Safety (x402 paid MCP) Paid MCP tools for URL payment-safety scanning and provider recommendations; USDC on Ba...

المالية والمدفوعات