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

Related MCP server: forge-agent-gate

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.