twofold-mcp

What it does

Sixteen tools over stdio. Each reply renders as terminal output, so you can read the state your agent acted on at a glance:

│ TWO/USDG   │    $205.46 │ ████████████████████████ │ 325,505.92 TWO │
│ USDe/USDG  │    $150.00 │ ██████████████████░░░░░░ │    149.53 USDe │

TVL, last 30h:  ▁▂▂▂▂▂▂▁▂▁▂▂▂▂▃▄▅▁▃▇▇▇▇▇▇█████

Related MCP server: HyperEVM MCP

Quickstart

npx twofold-mcp        # or: npm i -g twofold-mcp

Register it with your MCP host. For Claude Code, put this in your project's .mcp.json:

{ "mcpServers": { "twofold": { "command": "npx", "args": ["-y", "twofold-mcp"] } } }

For Claude Desktop, add the same entry under mcpServers in claude_desktop_config.json.

The wallet

On first run the server generates a fresh private key and stores it at ~/.twofold/wallet.key (mode 600). It never imports or touches a key you already own. Ask your agent for wallet_info, send that address a little ETH for gas plus the USDG you want it to trade on Robinhood Chain (chain id 4663), and the tools go live.

• TWOFOLD_KEYFILE moves the key somewhere else.

• TWOFOLD_RPC points at your own endpoint instead of the public rpc.mainnet.chain.robinhood.com.

Safety model

• The wallet spends only what you send it.

• The server quotes each swap through the on-chain Quoter first and executes with a real amountOutMinimum, not zero.

• Deposits and withdrawals carry slippage caps on both legs, 0.50% by default.

• There is no backend and nothing custodial: the server talks straight to the chain, and whoever holds pool shares can burn them back to tokens.

What Twofold is

Twofold pools pair tokenized equities (SPY, NVDA, TSLA, GME and more) and other assets against USDG. Idle USDG earns lending yield in ERC-4626 vaults while the same dollars quote swaps: one deposit, two yields. Live numbers: twofold.fi/stats.