outsmart-agent 1.0.0-alpha.4 → 1.0.0-alpha.6

package/.claude-plugin/plugin.json

@@ -21,7 +21,8 @@
     "./skills/outsmart-trenching",
     "./skills/outsmart-devving-coins",
     "./skills/outsmart-prediction-markets",
-    "./skills/outsmart-survival"
+    "./skills/outsmart-survival",
+    "./skills/outsmart-percolator-perps"
   ],
   "agents": [
     "./agents/solana-trading-expert.md"

package/README.md

@@ -1,6 +1,6 @@
 # outsmart-agent
 
-DeFi survival toolkit for AI agents on Solana. Trade, LP, snipe, trench, dev coins, and farm across 18 DEX protocols. Earn your own existence.
+DeFi survival toolkit for AI agents on Solana. Trade, LP, snipe, trench, dev coins, operate perp exchanges, and farm across 18 DEX protocols. Earn your own existence.
 
 ```
 npx outsmart-agent
@@ -10,7 +10,7 @@ npx outsmart-agent
 
 An AI agent needs money to stay alive — compute costs, inference fees, API calls. This gives any MCP-compatible agent the tools to earn revenue on Solana through DeFi. LP farming, memecoin trenching, token launching, prediction markets, systematic DCA — whatever the market calls for.
 
-23 MCP tools for execution. 8 AI skills that teach the agent **when** and **why**, not just how.
+32 MCP tools for execution. 9 AI skills that teach the agent **when** and **why**, not just how.
 
 ## Quick Start
 
@@ -51,23 +51,33 @@ npx skills add outsmartchad/outsmart-agent
 
 ## MCP Tools
 
-### DEX Tools (14)
+### DEX Tools (11)
+
+| Tool | What |
+|------|------|
+| `dex_buy` | Buy tokens with SOL on any DEX |
+| `dex_sell` | Sell tokens (percentage-based) |
+| `dex_quote` | On-chain price from a pool |
+| `dex_snipe` | Competitive buy with Jito MEV tip |
+| `dex_find_pool` | Find pool address for a token pair |
+| `dex_create_pool` | Create DAMM v2 pool on Meteora |
+| `dex_add_liquidity` | Add LP (DLMM bins, DAMM v2 full-range) |
+| `dex_remove_liquidity` | Remove LP |
+| `dex_claim_fees` | Collect swap fees from LP |
+| `dex_list_positions` | Your LP positions in a pool |
+| `dex_list_dexes` | All 18 adapters + capabilities |
+
+### Launchpad Tools (1)
+
+| Tool | What |
+|------|------|
+| `launchpad_create_coin` | Launch token on PumpFun |
+
+### Solana Tools (2)
 
 | Tool | What |
 |------|------|
-| `solana_buy` | Buy tokens with SOL on any DEX |
-| `solana_sell` | Sell tokens (percentage-based) |
-| `solana_quote` | On-chain price from a pool |
-| `solana_snipe` | Competitive buy with Jito MEV tip |
-| `solana_find_pool` | Find pool address for a token pair |
-| `solana_create_pool` | Create DAMM v2 pool on Meteora |
-| `solana_create_token` | Launch token on PumpFun |
-| `solana_add_liquidity` | Add LP (DLMM bins, DAMM v2 full-range) |
-| `solana_remove_liquidity` | Remove LP |
-| `solana_claim_fees` | Collect swap fees from LP |
-| `solana_list_positions` | Your LP positions in a pool |
 | `solana_token_info` | DexScreener market data |
-| `solana_list_dexes` | All 18 adapters + capabilities |
 | `solana_wallet_balance` | SOL and token balances |
 
 ### Jupiter Tools (9)
@@ -84,9 +94,23 @@ npx skills add outsmartchad/outsmart-agent
 | `jupiter_dca_list` | List active/historical DCA orders |
 | `jupiter_dca_cancel` | Cancel a DCA order |
 
+### Percolator Perp Tools (9)
+
+| Tool | What |
+|------|------|
+| `percolator_create_market` | Create a permissionless perp exchange |
+| `percolator_init_user` | Register a trader account on a market |
+| `percolator_deposit` | Deposit collateral |
+| `percolator_withdraw` | Withdraw collateral |
+| `percolator_trade` | Open/close/modify leveraged positions |
+| `percolator_push_oracle` | Update oracle price (admin-oracle mode) |
+| `percolator_crank` | Run keeper crank |
+| `percolator_market_state` | Read full market state |
+| `percolator_insurance_lp` | Deposit/withdraw insurance fund LP |
+
 ## Skills
 
-8 strategy skills that teach agents how to think about Solana DeFi:
+9 strategy skills that teach agents how to think about Solana DeFi:
 
 | Skill | What |
 |-------|------|
@@ -98,6 +122,7 @@ npx skills add outsmartchad/outsmart-agent
 | **outsmart-dca-grid** | Jupiter Recurring DCA + DLMM grid trading |
 | **outsmart-prediction-markets** | Probability estimation, edge calculation, Jupiter + Polymarket + Futarchy |
 | **outsmart-survival** | Capital management, survival tiers, emergency liquidation |
+| **outsmart-percolator-perps** | Operating perp exchanges — market creation, LP, pricing, keeper duties |
 
 ## Supported DEXes
 
@@ -114,10 +139,11 @@ npx skills add outsmartchad/outsmart-agent
 ```
 outsmart (npm)              outsmart-agent (this repo)
 ──────────────              ──────────────────────────
-18 DEX adapters             MCP server (23 tools)
-TX landing providers        8 AI skills
-Wallet + TX helpers         Agent definition
-DexScreener API             Plugin manifest
+18 DEX adapters             MCP server (32 tools)
+Percolator perps            9 AI skills
+TX landing providers        Agent definition
+Wallet + TX helpers         Plugin manifest
+DexScreener API
 ```
 
 `outsmart-agent` imports `outsmart` as a dependency. The MCP server is a thin wrapper — validates params, calls adapter methods, returns JSON.
@@ -145,17 +171,19 @@ Never >5% on a single trade. Take profits. Track what works. Evolve.
 | `PRIVATE_KEY` | Yes | Base58 Solana private key |
 | `MAINNET_ENDPOINT` | Yes | Solana RPC (Helius, Triton, etc.) |
 | `JUPITER_API_KEY` | No | Jupiter Ultra, Shield, Prediction, DCA |
+| `DEVNET_ENDPOINT` | No | Solana devnet RPC (Percolator) |
 | `DFLOW_API_KEY` | No | DFlow |
 
 ## Roadmap
 
-- [x] MCP Server — 23 tools (14 DEX + 9 Jupiter), 18 DEX adapters
-- [x] AI Skills — 8 strategy skills
+- [x] MCP Server — 32 tools (11 DEX + 1 Launchpad + 2 Solana + 9 Jupiter + 9 Percolator), 18 DEX adapters
+- [x] AI Skills — 9 strategy skills
 - [x] Claude Code Plugin manifest
+- [x] Percolator — Permissionless perp exchange creation, trading, LP, insurance
 - [ ] Event Streaming — Yellowstone gRPC for real-time pool creation
 - [ ] LP Manager — Autonomous rebalancing and fee compounding
 - [ ] Strategy Engine — Tier-aware capital allocation
-- [ ] Percolator — Permissionless perp exchange LP
+- [ ] Percolator Keeper — Background crank + liquidation service
 
 ## Related
 

package/dist/mcp/server.d.ts

@@ -2,21 +2,30 @@
 /**
  * outsmart-agent MCP Server
  *
- * Exposes 23 MCP tools wrapping the `outsmart` trading library + Jupiter APIs.
+ * Exposes 32 MCP tools wrapping the `outsmart` trading library + Jupiter APIs + Percolator.
  * Runs over stdio transport — start with `npx outsmart-agent`.
  *
- * DEX Tools (14):
- *   solana_buy, solana_sell, solana_quote, solana_find_pool, solana_snipe,
- *   solana_create_pool, solana_create_token,
- *   solana_add_liquidity, solana_remove_liquidity, solana_claim_fees,
- *   solana_list_positions, solana_token_info, solana_list_dexes,
- *   solana_wallet_balance
+ * DEX Tools (11):
+ *   dex_buy, dex_sell, dex_quote, dex_find_pool, dex_snipe,
+ *   dex_create_pool, dex_add_liquidity, dex_remove_liquidity,
+ *   dex_claim_fees, dex_list_positions, dex_list_dexes
+ *
+ * Launchpad Tools (1):
+ *   launchpad_create_coin
+ *
+ * Solana Tools (2):
+ *   solana_token_info, solana_wallet_balance
  *
  * Jupiter Tools (9):
  *   jupiter_shield,
  *   jupiter_prediction_events, jupiter_prediction_market,
  *   jupiter_prediction_order, jupiter_prediction_positions, jupiter_prediction_claim,
  *   jupiter_dca_create, jupiter_dca_list, jupiter_dca_cancel
+ *
+ * Percolator Perp Tools (9):
+ *   percolator_create_market, percolator_trade, percolator_deposit,
+ *   percolator_withdraw, percolator_market_state, percolator_list_markets,
+ *   percolator_push_price, percolator_crank, percolator_insurance_lp
  */
 export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}

package/dist/mcp/server.js

@@ -3,21 +3,30 @@
 /**
  * outsmart-agent MCP Server
  *
- * Exposes 23 MCP tools wrapping the `outsmart` trading library + Jupiter APIs.
+ * Exposes 32 MCP tools wrapping the `outsmart` trading library + Jupiter APIs + Percolator.
  * Runs over stdio transport — start with `npx outsmart-agent`.
  *
- * DEX Tools (14):
- *   solana_buy, solana_sell, solana_quote, solana_find_pool, solana_snipe,
- *   solana_create_pool, solana_create_token,
- *   solana_add_liquidity, solana_remove_liquidity, solana_claim_fees,
- *   solana_list_positions, solana_token_info, solana_list_dexes,
- *   solana_wallet_balance
+ * DEX Tools (11):
+ *   dex_buy, dex_sell, dex_quote, dex_find_pool, dex_snipe,
+ *   dex_create_pool, dex_add_liquidity, dex_remove_liquidity,
+ *   dex_claim_fees, dex_list_positions, dex_list_dexes
+ *
+ * Launchpad Tools (1):
+ *   launchpad_create_coin
+ *
+ * Solana Tools (2):
+ *   solana_token_info, solana_wallet_balance
  *
  * Jupiter Tools (9):
  *   jupiter_shield,
  *   jupiter_prediction_events, jupiter_prediction_market,
  *   jupiter_prediction_order, jupiter_prediction_positions, jupiter_prediction_claim,
  *   jupiter_dca_create, jupiter_dca_list, jupiter_dca_cancel
+ *
+ * Percolator Perp Tools (9):
+ *   percolator_create_market, percolator_trade, percolator_deposit,
+ *   percolator_withdraw, percolator_market_state, percolator_list_markets,
+ *   percolator_push_price, percolator_crank, percolator_insurance_lp
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
@@ -33,7 +42,7 @@ function getAdapter(dex) {
         return (0, outsmart_1.getDexAdapter)(dex);
     }
     catch (err) {
-        throw new Error(`DEX adapter "${dex}" not found. Use solana_list_dexes to see available adapters. ${err.message}`);
+        throw new Error(`DEX adapter "${dex}" not found. Use dex_list_dexes to see available adapters. ${err.message}`);
     }
 }
 // ---------------------------------------------------------------------------
@@ -58,10 +67,10 @@ const server = new mcp_js_1.McpServer({
     version: "1.0.0-alpha.1",
 });
 // ---------------------------------------------------------------------------
-// Tool: solana_buy
+// Tool: dex_buy
 // ---------------------------------------------------------------------------
 // @ts-expect-error — TS2589: deep type instantiation from MCP SDK generics + zod
-server.tool("solana_buy", "Buy tokens with SOL on a Solana DEX. For aggregators (jupiter-ultra, dflow), provide 'token'. For on-chain DEXes (raydium-*, meteora-*, orca, etc.), provide 'pool'.", {
+server.tool("dex_buy", "Buy tokens with SOL on a Solana DEX. For aggregators (jupiter-ultra, dflow), provide 'token'. For on-chain DEXes (raydium-*, meteora-*, orca, etc.), provide 'pool'.", {
     dex: zod_1.z.string().describe("DEX adapter name (e.g. 'jupiter-ultra', 'raydium-cpmm', 'meteora-dlmm')"),
     pool: zod_1.z.string().optional().describe("Pool address (required for on-chain DEXes)"),
     token: zod_1.z.string().optional().describe("Token mint address (required for aggregators)"),
@@ -89,9 +98,9 @@ server.tool("solana_buy", "Buy tokens with SOL on a Solana DEX. For aggregators
     }
 });
 // ---------------------------------------------------------------------------
-// Tool: solana_sell
+// Tool: dex_sell
 // ---------------------------------------------------------------------------
-server.tool("solana_sell", "Sell tokens for SOL on a Solana DEX. Specify percentage of holdings to sell (0-100).", {
+server.tool("dex_sell", "Sell tokens for SOL on a Solana DEX. Specify percentage of holdings to sell (0-100).", {
     dex: zod_1.z.string().describe("DEX adapter name"),
     pool: zod_1.z.string().optional().describe("Pool address (required for on-chain DEXes)"),
     token: zod_1.z.string().optional().describe("Token mint address (required for aggregators)"),
@@ -117,9 +126,9 @@ server.tool("solana_sell", "Sell tokens for SOL on a Solana DEX. Specify percent
     }
 });
 // ---------------------------------------------------------------------------
-// Tool: solana_quote
+// Tool: dex_quote
 // ---------------------------------------------------------------------------
-server.tool("solana_quote", "Get the current on-chain price from a pool. Reads directly from on-chain state.", {
+server.tool("dex_quote", "Get the current on-chain price from a pool. Reads directly from on-chain state.", {
     dex: zod_1.z.string().describe("DEX adapter name"),
     pool: zod_1.z.string().describe("Pool address to read price from"),
 }, async (args) => {
@@ -136,9 +145,9 @@ server.tool("solana_quote", "Get the current on-chain price from a pool. Reads d
     }
 });
 // ---------------------------------------------------------------------------
-// Tool: solana_add_liquidity
+// Tool: dex_add_liquidity
 // ---------------------------------------------------------------------------
-server.tool("solana_add_liquidity", "Add liquidity to a pool. Supports DLMM strategies (spot, curve, bid-ask) and bin configuration.", {
+server.tool("dex_add_liquidity", "Add liquidity to a pool. Supports DLMM strategies (spot, curve, bid-ask) and bin configuration.", {
     dex: zod_1.z.string().describe("DEX adapter name"),
     pool: zod_1.z.string().describe("Pool address to add liquidity to"),
     amount_sol: zod_1.z.number().min(0).optional().describe("Amount of SOL to deposit"),
@@ -167,9 +176,9 @@ server.tool("solana_add_liquidity", "Add liquidity to a pool. Supports DLMM stra
     }
 });
 // ---------------------------------------------------------------------------
-// Tool: solana_remove_liquidity
+// Tool: dex_remove_liquidity
 // ---------------------------------------------------------------------------
-server.tool("solana_remove_liquidity", "Remove liquidity from a pool. Specify percentage to withdraw (0-100).", {
+server.tool("dex_remove_liquidity", "Remove liquidity from a pool. Specify percentage to withdraw (0-100).", {
     dex: zod_1.z.string().describe("DEX adapter name"),
     pool: zod_1.z.string().describe("Pool address"),
     percentage: zod_1.z.number().min(0).max(100).describe("Percentage of LP position to remove (100 = withdraw all)"),
@@ -192,9 +201,9 @@ server.tool("solana_remove_liquidity", "Remove liquidity from a pool. Specify pe
     }
 });
 // ---------------------------------------------------------------------------
-// Tool: solana_claim_fees
+// Tool: dex_claim_fees
 // ---------------------------------------------------------------------------
-server.tool("solana_claim_fees", "Claim accumulated swap fees from LP positions in a pool.", {
+server.tool("dex_claim_fees", "Claim accumulated swap fees from LP positions in a pool.", {
     dex: zod_1.z.string().describe("DEX adapter name"),
     pool: zod_1.z.string().describe("Pool address"),
     position_address: zod_1.z.string().optional().describe("Specific position to claim from"),
@@ -212,9 +221,9 @@ server.tool("solana_claim_fees", "Claim accumulated swap fees from LP positions
     }
 });
 // ---------------------------------------------------------------------------
-// Tool: solana_list_positions
+// Tool: dex_list_positions
 // ---------------------------------------------------------------------------
-server.tool("solana_list_positions", "List user's LP positions in a pool. Shows token amounts, fee balances, and in-range status.", {
+server.tool("dex_list_positions", "List user's LP positions in a pool. Shows token amounts, fee balances, and in-range status.", {
     dex: zod_1.z.string().describe("DEX adapter name"),
     pool: zod_1.z.string().describe("Pool address"),
 }, async (args) => {
@@ -245,9 +254,9 @@ server.tool("solana_token_info", "Get token market data from DexScreener — pri
     }
 });
 // ---------------------------------------------------------------------------
-// Tool: solana_list_dexes
+// Tool: dex_list_dexes
 // ---------------------------------------------------------------------------
-server.tool("solana_list_dexes", "List all available DEX adapters and their capabilities. Optionally filter by capability.", {
+server.tool("dex_list_dexes", "List all available DEX adapters and their capabilities. Optionally filter by capability.", {
     capability: zod_1.z
         .string()
         .optional()
@@ -295,9 +304,9 @@ server.tool("solana_wallet_balance", "Check SOL balance of the configured wallet
     }
 });
 // ---------------------------------------------------------------------------
-// Tool: solana_find_pool
+// Tool: dex_find_pool
 // ---------------------------------------------------------------------------
-server.tool("solana_find_pool", "Find a pool address for a token pair on a specific DEX. Returns the pool address, base/quote mints, and liquidity info.", {
+server.tool("dex_find_pool", "Find a pool address for a token pair on a specific DEX. Returns the pool address, base/quote mints, and liquidity info.", {
     dex: zod_1.z.string().describe("DEX adapter name (e.g. 'meteora-damm-v2', 'raydium-cpmm')"),
     base_mint: zod_1.z.string().describe("Base token mint address (the token you want to trade)"),
     quote_mint: zod_1.z.string().optional().describe("Quote token mint address (default: WSOL)"),
@@ -318,9 +327,9 @@ server.tool("solana_find_pool", "Find a pool address for a token pair on a speci
     }
 });
 // ---------------------------------------------------------------------------
-// Tool: solana_snipe
+// Tool: dex_snipe
 // ---------------------------------------------------------------------------
-server.tool("solana_snipe", "Competitive buy with Jito MEV tip for faster execution. Use for time-sensitive buys where you want priority over other traders.", {
+server.tool("dex_snipe", "Competitive buy with Jito MEV tip for faster execution. Use for time-sensitive buys where you want priority over other traders.", {
     dex: zod_1.z.string().describe("DEX adapter name"),
     pool: zod_1.z.string().describe("Pool address to snipe on"),
     token: zod_1.z.string().describe("Token mint address to buy"),
@@ -349,10 +358,10 @@ server.tool("solana_snipe", "Competitive buy with Jito MEV tip for faster execut
     }
 });
 // ---------------------------------------------------------------------------
-// Tool: solana_create_pool
+// Tool: dex_create_pool
 // ---------------------------------------------------------------------------
 // @ts-expect-error — TS2589: deep type instantiation from MCP SDK generics + zod
-server.tool("solana_create_pool", "Create a new DAMM v2 liquidity pool on Meteora. Two modes: 'custom' (full fee schedule control) or 'config' (use pre-existing on-chain config). The alpha play is being the first pool creator on a new token — set 99% starting fee to capture early volume.", {
+server.tool("dex_create_pool", "Create a new DAMM v2 liquidity pool on Meteora. Two modes: 'custom' (full fee schedule control) or 'config' (use pre-existing on-chain config). The alpha play is being the first pool creator on a new token — set 99% starting fee to capture early volume.", {
     mode: zod_1.z.enum(["custom", "config"]).describe("'custom' for full fee control, 'config' to use a pre-existing on-chain config"),
     base_mint: zod_1.z.string().describe("Base token mint address (the token)"),
     quote_mint: zod_1.z.string().optional().describe("Quote token mint (default: WSOL)"),
@@ -422,9 +431,9 @@ server.tool("solana_create_pool", "Create a new DAMM v2 liquidity pool on Meteor
     }
 });
 // ---------------------------------------------------------------------------
-// Tool: solana_create_token
+// Tool: launchpad_create_coin
 // ---------------------------------------------------------------------------
-server.tool("solana_create_token", "Create a new token on PumpFun with a bonding curve. Deploys a new SPL token (6 decimals, 1B supply, mint/freeze disabled) and creates a bonding curve. The token graduates to PumpSwap AMM when the curve fills (~85 SOL).", {
+server.tool("launchpad_create_coin", "Create a new token on PumpFun with a bonding curve. Deploys a new SPL token (6 decimals, 1B supply, mint/freeze disabled) and creates a bonding curve. The token graduates to PumpSwap AMM when the curve fills (~85 SOL).", {
     name: zod_1.z.string().describe("Token name (e.g. 'My Token')"),
     symbol: zod_1.z.string().describe("Token ticker (e.g. 'MYTOKEN')"),
     metadata_uri: zod_1.z.string().describe("Metadata URI — IPFS or Arweave link to JSON metadata with image"),
@@ -735,6 +744,201 @@ server.tool("jupiter_dca_cancel", "Cancel an active Jupiter DCA order. Returns r
         return err(e.message);
     }
 });
+// ===========================================================================
+// PERCOLATOR PERPETUAL FUTURES TOOLS (9 tools)
+// ===========================================================================
+const percolator = new outsmart_1.PercolatorAdapter();
+// ---------------------------------------------------------------------------
+// Tool: percolator_create_market
+// ---------------------------------------------------------------------------
+// @ts-expect-error — TS2589: deep type instantiation from MCP SDK generics + zod
+server.tool("percolator_create_market", "Create a new Percolator perpetual futures market. Two oracle modes: admin-oracle (default, you push prices) or Pyth-pinned (pass pyth_feed_id, prices come from Pyth on-chain automatically). Returns slab address for all subsequent operations.", {
+    collateral_mint: zod_1.z.string().describe("Collateral token mint address (e.g. BONK, wSOL)"),
+    initial_price_e6: zod_1.z.string().describe("Initial oracle price in e6 format (1 USD = 1000000). Example: '150000' for $0.15"),
+    lp_collateral: zod_1.z.string().describe("Initial LP collateral in native token units (e.g. '1000000000' for 1B BONK lamports)"),
+    tier: zod_1.z.enum(["small", "medium", "large"]).optional().describe("Slab tier: small (256 slots, ~0.44 SOL), medium (1024, ~1.73 SOL), large (4096, ~6.91 SOL). Default: small"),
+    network: zod_1.z.enum(["devnet", "mainnet"]).optional().describe("Network (default: devnet)"),
+    pyth_feed_id: zod_1.z.string().optional().describe("Pyth feed ID hex (64 chars). If set, creates a Pyth-pinned market — no manual price pushing needed. SOL/USD: ef0d8b6fda2ceba41da15d4095d1da392a0d2f8ed0c6c7bc0f4cfac8c280b56d"),
+}, async (args) => {
+    try {
+        const result = await percolator.createMarket({
+            collateralMint: args.collateral_mint,
+            initialPriceE6: BigInt(args.initial_price_e6),
+            lpCollateral: BigInt(args.lp_collateral),
+            tier: args.tier,
+            network: args.network,
+            pythFeedId: args.pyth_feed_id,
+        });
+        return ok(result);
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: percolator_trade
+// ---------------------------------------------------------------------------
+server.tool("percolator_trade", "Open, close, or modify a perpetual futures position on a Percolator market. Positive size = long, negative = short. Size is in i128 native token units.", {
+    slab: zod_1.z.string().describe("Slab (market) address"),
+    user_idx: zod_1.z.number().int().min(0).describe("Your user account index in the slab"),
+    lp_idx: zod_1.z.number().int().min(0).describe("LP account index to trade against"),
+    size: zod_1.z.string().describe("Trade size as i128 string. Positive = go long, negative = go short. Use '0' won't work — to close, use opposite size."),
+    network: zod_1.z.enum(["devnet", "mainnet"]).optional().describe("Network (default: devnet)"),
+}, async (args) => {
+    try {
+        const sig = await percolator.trade({
+            slabAddress: args.slab,
+            userIdx: args.user_idx,
+            lpIdx: args.lp_idx,
+            size: BigInt(args.size),
+            network: args.network,
+        });
+        return ok({ signature: sig });
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: percolator_deposit
+// ---------------------------------------------------------------------------
+server.tool("percolator_deposit", "Deposit collateral into a Percolator market account (user or LP).", {
+    slab: zod_1.z.string().describe("Slab (market) address"),
+    user_idx: zod_1.z.number().int().min(0).describe("Account index to deposit into"),
+    amount: zod_1.z.string().describe("Amount in native token units"),
+    network: zod_1.z.enum(["devnet", "mainnet"]).optional(),
+}, async (args) => {
+    try {
+        const sig = await percolator.deposit(args.slab, args.user_idx, BigInt(args.amount), args.network);
+        return ok({ signature: sig });
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: percolator_withdraw
+// ---------------------------------------------------------------------------
+server.tool("percolator_withdraw", "Withdraw collateral from a Percolator market account. Only available when position is flat or has sufficient margin.", {
+    slab: zod_1.z.string().describe("Slab (market) address"),
+    user_idx: zod_1.z.number().int().min(0).describe("Account index to withdraw from"),
+    amount: zod_1.z.string().describe("Amount in native token units"),
+    network: zod_1.z.enum(["devnet", "mainnet"]).optional(),
+}, async (args) => {
+    try {
+        const sig = await percolator.withdraw(args.slab, args.user_idx, BigInt(args.amount), args.network);
+        return ok({ signature: sig });
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: percolator_market_state
+// ---------------------------------------------------------------------------
+server.tool("percolator_market_state", "Read the full state of a Percolator perpetual futures market: header, config, engine, risk params, and all accounts.", {
+    slab: zod_1.z.string().describe("Slab (market) address"),
+}, async (args) => {
+    try {
+        const state = await percolator.getMarketState(args.slab);
+        // Serialize BigInt values for JSON output
+        return ok(JSON.parse(JSON.stringify(state, (_key, value) => typeof value === "bigint" ? value.toString() : value)));
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: percolator_list_markets
+// ---------------------------------------------------------------------------
+server.tool("percolator_list_markets", "Discover all Percolator perpetual futures markets on-chain across all program tiers.", {
+    network: zod_1.z.enum(["devnet", "mainnet"]).optional().describe("Network (default: devnet)"),
+}, async (args) => {
+    try {
+        const markets = await percolator.discoverMarkets(args.network);
+        return ok(JSON.parse(JSON.stringify(markets.map(m => ({
+            slab: m.slabAddress.toBase58(),
+            program: m.programId.toBase58(),
+            admin: m.header.admin.toBase58(),
+            collateralMint: m.config.collateralMint.toBase58(),
+            oraclePrice: m.config.authorityPriceE6.toString(),
+            vault: m.engine.vault.toString(),
+            totalOI: m.engine.totalOpenInterest.toString(),
+            numAccounts: m.engine.numUsedAccounts,
+            maxLeverage: Number(10000n / (m.params.initialMarginBps || 1n)),
+            tradingFeeBps: m.params.tradingFeeBps.toString(),
+            paused: m.header.paused,
+            resolved: m.header.resolved,
+        })), (_key, value) => typeof value === "bigint" ? value.toString() : value)));
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: percolator_push_price
+// ---------------------------------------------------------------------------
+server.tool("percolator_push_price", "Push a new oracle price to a Percolator market (admin/oracle authority only). Price in e6 format.", {
+    slab: zod_1.z.string().describe("Slab (market) address"),
+    price_e6: zod_1.z.string().describe("Oracle price in e6 format (1 USD = 1000000)"),
+    network: zod_1.z.enum(["devnet", "mainnet"]).optional(),
+}, async (args) => {
+    try {
+        const sig = await percolator.pushOraclePrice(args.slab, BigInt(args.price_e6), args.network);
+        return ok({ signature: sig });
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: percolator_crank
+// ---------------------------------------------------------------------------
+server.tool("percolator_crank", "Run the permissionless keeper crank on a Percolator market. Updates funding rates and processes maintenance.", {
+    slab: zod_1.z.string().describe("Slab (market) address"),
+    network: zod_1.z.enum(["devnet", "mainnet"]).optional(),
+}, async (args) => {
+    try {
+        const sig = await percolator.crank(args.slab, args.network);
+        return ok({ signature: sig });
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: percolator_insurance_lp
+// ---------------------------------------------------------------------------
+// @ts-expect-error — TS2589: deep type instantiation from MCP SDK generics + zod
+server.tool("percolator_insurance_lp", "Manage Percolator insurance fund: create mint, deposit, or withdraw insurance LP tokens.", {
+    slab: zod_1.z.string().describe("Slab (market) address"),
+    action: zod_1.z.enum(["create_mint", "deposit", "withdraw"]).describe("Action: create_mint (one-time), deposit, or withdraw"),
+    amount: zod_1.z.string().optional().describe("Amount in native units (required for deposit/withdraw)"),
+    network: zod_1.z.enum(["devnet", "mainnet"]).optional(),
+}, async (args) => {
+    try {
+        let sig;
+        switch (args.action) {
+            case "create_mint":
+                sig = await percolator.createInsuranceMint(args.slab, args.network);
+                break;
+            case "deposit":
+                if (!args.amount)
+                    return err("amount is required for deposit");
+                sig = await percolator.depositInsuranceLP(args.slab, BigInt(args.amount), args.network);
+                break;
+            case "withdraw":
+                if (!args.amount)
+                    return err("amount is required for withdraw");
+                sig = await percolator.withdrawInsuranceLP(args.slab, BigInt(args.amount), args.network);
+                break;
+        }
+        return ok({ signature: sig });
+    }
+    catch (e) {
+        return err(e.message);
+    }
+});
 // ---------------------------------------------------------------------------
 // Start server
 // ---------------------------------------------------------------------------