Tychi Mcp

by TychiWallet

252 downloads

Not rated

GitHub

About

Give your AI agent a wallet it can actually use. Tychi MCP plugs into Cursor, Claude Desktop, OpenClaw, and any stdio MCP host — onboard, create, import, and switch wallets with fast direct tools, then balance checks, sends, and policy-gated payments through tyi_chat. Keys live e

Details

Author: TychiWallet
Downloads: 252
Categories: AI

- Intent‑to‑tool routing via tyi_route (avoids slow misuse of tyi_chat)
- Readiness gate tyi_status before any wallet action
- Onboarding tools: tyi_onboard and tyi_onboard_schema
- Wallet lifecycle: create, import (mnemonic/privkey), and switch wallets
- Policy caps on spending enforced before signing
- Local signing – private keys always on the operator machine
- Gasless routing via UGF payment rails for cross‑chain settlement
- Local audit log in ~/.tyi and reset capability (tyi_reset)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Tychi Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

From the repository

Install via npx -y @tychilabs/tyi-mcp@beta and configure the MCP host with the TYI_PASSWORD (set after onboarding) and optionally TYCHI_BRAIN_URL. The agent must follow a mandatory flow: first call tyi_route, then tyi_status to check readiness, then either a direct tool (onboard/create/import/switch/reset) for fast operations or tyi_chat for balance/sends/payments/policy. Never call tyi_chat when tyi_status.ready is false.

`tyi_route`

READ FIRST. Intent → tool map. Call before any wallet op. Prevents slow tyi_chat misuse.

`tyi_status`

Check ready + missing. Call once at session start.

`tyi_onboard_schema`

Onboarding field schema. Use with tyi_onboard — not tyi_chat.

`tyi_onboard`

FAST. First-time setup only. NOT tyi_chat.

`tyi_create_wallet`

FAST. New wallet by name. User said create/new wallet → call this NOT tyi_chat.

`tyi_import_wallet`

FAST. Import seed/privkey. User said import/restore → call this NOT tyi_chat. Secret via tool param only.

`tyi_switch_wallet`

FAST. Set active wallet by name. NOT tyi_chat.

`tyi_reset`

Wipe ~/.tyi. confirm:true required. NOT tyi_chat.

`tyi_chat`

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "tychi mcp": {
            "tychi": {
                "command": "npx",
                "args": [
                    "-y",
                    "@tychilabs/tyi-mcp@beta"
                ],
                "env": {
                    "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
                    "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
                }
            }
        }
    }
}

McpServers

{
    "tychi": {
        "command": "npx",
        "args": [
            "-y",
            "@tychilabs/tyi-mcp@beta"
        ],
        "env": {
            "TYI_PASSWORD": "<keystore-password-after-tyi_onboard>",
            "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
        }
    }
}

Tychi MCP

Give your AI agent a wallet — onboard, hold funds, send, and pay under policy. Agent-native MCP server for stdio hosts. Fast direct tools for wallet setup and ops; tyi_chat for balance, sends, and policy-gated payments. Keys encrypted in ~/.tyi on the operator's machine. Hosted brain parses intent and routes LLM — signing never leaves the device.

Agents → @tychilabs/tyi-mcp · Humans → @tychilabs/tyi 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 ---

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

bash
npx -y @tychilabs/tyi-mcp@beta
npx @tychilabs/tyi-mcp@beta --tools



---

MCP host config

json
{
  "mcpServers": {
    "tychi": {
      "command": "npx",
      "args": ["-y", "@tychilabs/tyi-mcp@beta"],
      "env": {
        "TYI_PASSWORD": "<from tyi_onboard>",
        "TYCHI_BRAIN_URL": "http://hosted_brain.tychilabs.com"
      }
    }
  }
}



---

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.

Set

TYI_PASSWORD

 in MCP host env after onboard — not in chat.

---

Environment


| Variable | Required | Default |
|----------|----------|---------|
|

TYI_PASSWORD

 | After onboard | — |
|

TYCHI_BRAIN_URL | No | http://hosted_brain.tychilabs.com

|
|

TYI_DATA_DIR | No | ~/.tyi

|
|

KEYSTORE_PASSWORD | Alias | same as TYI_PASSWORD` | ---

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-2.0 — see LICENSE

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

tyi_route

tyi_status

tyi_onboard_schema

tyi_onboard

tyi_create_wallet

tyi_import_wallet

tyi_switch_wallet

tyi_reset

tyi_chat

Claude Desktop / Cursor

McpServers

Tychi MCP

What it does

Agent flow (mandatory)

Tools

Install

MCP host config

Onboarding modes

Environment

Links

License

Install

More like this

Context 7

1Panel

🔎 GPT Researcher

Serena

FastMCP v2 🚀

MaxKB

`tyi_route`

`tyi_status`

`tyi_onboard_schema`

`tyi_onboard`

`tyi_create_wallet`

`tyi_import_wallet`

`tyi_switch_wallet`

`tyi_reset`

`tyi_chat`