fund402-mcp

Talk to the Fund402 JIT-credit protocol in plain English and watch it take real on-chain actions on Casper.

Two front-ends over the same fund402-agent toolbox:

1. TUI — a terminal chat console. You type; Groq (the LLM) decides which tools to call; the tools execute live on casper-test and stream their logs (deploy hashes, cspr.live links, balances) right in front of you.
2. MCP server — exposes every Fund402 tool over stdio to any MCP client (Claude Desktop, etc.).

 you ──▶ TUI / MCP client ──▶ Groq (tool-calling) ──▶ fund402-agent tools ──▶ Casper testnet
                                                                      └─▶ x402 facilitator

The TUI

npm install
# config (key) lives in ../fund402-agent/.env — GROQ_API_KEY + CSPR_CLOUD_API_KEY
npm run tui

Then just talk:

you ▸ create a wallet called bob, fund it, make it Tier 3, and borrow 0.001 to pay for a price feed

🔧 create_wallet {"name":"bob"}
🔧 fund_wallet_cspr {"account":"bob","cspr":60}
🔧 award_reputation {"account":"bob","delta":250}
🔧 borrow_and_pay {"agent":"bob","amount":1000000,"resource":"price feed"}
🤖 Done. bob is Tier 3 and just borrowed 0.001 F402 — the vault fronted the
   payment on-chain. Deploy: https://testnet.cspr.live/deploy/…

The model knows the protocol rules (fund-before-sign, Tier-3-for-zero-collateral, 9-decimal amounts) from its system prompt, so one sentence drives the whole sequence.

The MCP server (Claude Desktop)

// claude_desktop_config.json
{
  "mcpServers": {
    "fund402": {
      "command": "node",
      "args": ["/absolute/path/to/fund402-mcp/src/server.mjs"]
    }
  }
}

stdout is the JSON-RPC channel; all tool logs go to stderr, so the protocol stays clean. Run npm test for an MCP client smoke test (lists tools, calls get_pool_stats + get_balances live).

Tools

All 12 fund402-agent tools are exposed: create_wallet, list_wallets, get_balances, fund_wallet_cspr, fund_wallet_token, deposit_liquidity, award_reputation, borrow_and_pay, repay_loan, sign_x402_payment, get_pool_stats, check_deploy.

Verified live

Driven entirely from the TUI against the deployed vault 664d99de… + CEP-18 389cedc5… on casper-test: a fresh agent was created → funded → made Tier 3 → borrowed via the vault (x402 payment fronted + settled on-chain) → repaid (collateral released). Every step returned a real cspr.live deploy.

⚠️ Security

The TUI/MCP execute real signed deploys via fund402-agent's local keys. Keep .env and .wallets/ out of git — testnet only. License: Apache-2.0.