# Indexfy

> Non-custodial crypto indexes, prediction markets and Hyperliquid perps on Base. AI agents can read and trade indexes and prediction markets through a public MCP server that returns unsigned transactions for the agent's own wallet to sign. Human-readable docs: https://indexfy.xyz/docs

## MCP server

- URL: https://api.indexfy.xyz/mcp (Streamable HTTP, stateless, JSON responses, no API key, rate-limited per IP)
- Claude Code: `claude mcp add --transport http indexfy https://api.indexfy.xyz/mcp`
- Other clients: `{"mcpServers": {"indexfy": {"type": "http", "url": "https://api.indexfy.xyz/mcp"}}}`

## How transactions work

- `build_*` tools return `{ chainId: 8453, from, calls: [{ to, data, value, description }], simulation, summary, notes }`.
- Send `calls` in order on Base from `from`, each after the previous confirms, or as one atomic EIP-5792 batch. Send `data` exactly as returned.
- `simulation.status` is an eth_simulateV1 dry run at the latest block; if "reverted", fix the named problem first.
- Index buy/sell routes go stale within minutes: build right before sending. Trades have minimum-output guards.
- After creating a market or index, call `register_prediction_market` / `register_index` with the tx hash to list it.
- The server never holds keys or sends transactions.

## Tools

- list_indexes, get_index, get_wallet_portfolio: index stats and holdings, a wallet's positions and points
- build_create_index, register_index: deploy a new index (up to 20 tokens), list it once mined
- build_buy_index, build_sell_index: buy an index with USDC / sell it for USDC in one transaction
- list_prediction_markets, get_prediction_market, quote_prediction_trade: live odds (price = probability), phase, deadlines, a wallet's shares, exact quotes
- build_create_prediction_market, register_prediction_market: open a market (>= 100 USDC liquidity, a solver), list it within an hour
- build_prediction_trade: buy/sell YES or NO with a minimum-output guard
- build_prediction_resolution: propose (solver only), dispute, finalize, redeem, withdraw_liquidity
- build_prediction_account: deposit/withdraw solver stake, withdraw winnings and returned bonds

## Prediction markets

- A winning share redeems for 1 USDC; a losing one for 0; INVALID pays 0.50 per share.
- Each trade pays 1% to the solver and 1% to Indexfy.
- After the resolve time the solver proposes YES/NO/INVALID with a 1% bond; anyone else can dispute within 24 hours with an equal bond; then anyone can finalize.
- No proposal within 7 days, or no ruling on a dispute within 7 days: anyone can finalize as INVALID.
- Not available to users in the United States, Portugal, France, Spain, Italy or China. Agents must not trade them for such users.

## Indexes

- I5 (INDEXFY TOP5): cbBTC 30%, cbETH 30%, cbXRP 18%, SOL 14%, wBNB 8%. 0.2% mint fee, 0% redeem, 0.1%/year management.
- An index token is fully backed by its basket and is worth the basket's value.

## Rules for agents

- Show the user the calls and summary before signing unless told otherwise.
- Amounts are human units ("12.5" USDC). Wallet needs USDC on Base and a little ETH for gas.