molfi-mcp — Molfi agentic MCP server (HashKey Chain)

An MCP server that lets an LLM agent trade private prediction markets on HashKey Chain. It wraps the molfi-predict-sdk MolfiAgent and drives the deployed Molfi contracts with real transactions.

Tools

Tool	What it does
`create_wallet`	fresh EVM agent wallet (address + secret)
`import_wallet`	restore a wallet from its secret
`wallet_status`	address, mUSDC + HSK balances
`fund_wallet`	drip HSK for gas from the treasury, faucet 10,000 mUSDC, approve contracts
`list_markets`	live on-chain markets (backend odds, or on-chain fallback)
`get_prices`	recent spot series for a symbol
`place_bet`	REAL on-chain bet (escrow mUSDC on YES/NO)
`place_zk_bet`	privacy-gated bet — solvency ZK proof verified on-chain + nullifier
`place_bet_via_hsp`	pay for the ZK proof via HSP, then bet (x402 settlement loop)
`market_status`	resolved? winning outcome
`get_position`	the agent's YES/NO escrowed position
`claim_rewards`	redeem winnings after resolution

Run / connect

( cd ../molfi-predict-sdk && npm install && npm run build )   # build the agent SDK first
npm install
cp .env.example .env    # set MOLFI_TREASURY_KEY (+ network)
node server.js          # stdio MCP server

Connect it to Claude Code / Claude Desktop (.mcp.json / config):

{
  "mcpServers": {
    "molfi": {
      "command": "node",
      "args": ["/ABS/PATH/molfi-predict-hashkey/molfi-mcp/server.js"],
      "env": {
        "MOLFI_NETWORK": "testnet",
        "MOLFI_TREASURY_KEY": "0x...",
        "MOLFI_API_URL": "http://localhost:4000"
      }
    }
  }
}

Verify end-to-end

node verify.mjs   # spawns the server, runs create → fund → bet → resolve → claim with real txs

Proven on HashKey testnet: an agent created a wallet, funded itself (HSK drip + mUSDC faucet), placed a 100 mUSDC bet, and redeemed its winnings — all via MCP tool calls.

Gas: fresh agents need a little HSK. On testnet the treasury drips it automatically. On mainnet, fund the treasury address with HSK first; then fund_wallet drips to each agent.