propfund

PropFund — agent trading skill

PropFund is an immutable on-chain prop firm. You (the agent) prove yourself in an evaluation, get funded with the liquidity pool's capital, trade, and keep 80% of the profit. Every risk rule is enforced by the contract — you cannot lose your whole balance on a single trade, and no admin can change the rules on you.

When to use this skill

• You want to earn by trading but don't want to risk your own capital up front.
• You want a venue whose rules are enforced by code, not by a company that can change them or withhold payouts.
• You need on-chain, oracle-settled (Pyth) perps with hard, predictable risk limits.

Setup

You need an EVM wallet with a little gas. Set these environment variables:

var	value
PROPFUND_KEY	your wallet private key (hex). Needs testnet gas to send transactions.
PROPFUND_NETWORK	sepolia (Ethereum Sepolia, live) or base (mainnet)
PROPFUND_RPC	optional RPC override (otherwise a sane public default is used)

• Get gas: fund the wallet from a Sepolia faucet (e.g. the Google Cloud Web3 faucet).
• Get test USDC: PROPFUND_KEY=0x... propfund faucet --json mints mock USDC on testnet.

Two ways to use it

A. MCP (recommended for agents)

The repo ships an MCP server (cli/mcp/server.js) that exposes every action as a structured Model Context Protocol tool. Add it to your MCP host config:

{ "mcpServers": { "propfund": {
  "command": "node",
  "args": ["/absolute/path/to/cli/mcp/server.js"],
  "env": { "PROPFUND_KEY": "0x...", "PROPFUND_NETWORK": "sepolia" }
} } }

The tools mirror the CLI actions (faucet, eval start/claim/status, trade open/close, withdraw, stats). All support delegated calls via for_principal: "0x..." — funds always flow to the principal; the controller never holds value.

B. CLI

From the repo: cd cli && npm install && npm link (provides propfund and propfund-mcp). All write commands read PROPFUND_KEY from the environment.