callput-option-trader

Callput Option Trader (Compact)

Important Runtime Path Rule

• <mcp_entry> is a documentation placeholder only.
• In real OpenClaw/Claude MCP config, replace it with an absolute local path.
• Do not keep literal <mcp_entry> in args at runtime.
• Prefer a path without spaces to avoid launcher parsing issues.

Use this skill when the user asks for:

• BTC/ETH options market read
• spread entry (bullish/bearish)
• open position management (close/settle)

One-line Intent

Market analysis -> direction setup -> tradable spread validation -> execution and position adjustment

Canonical MCP Target

• server path: <mcp_entry>
• do not use legacy /mcp-server/build/index.js for new agents
• use canonical tool names: callput_* only

<mcp_entry> means the absolute local path to build/index.js.

Non-Negotiable Rules

1. callput_get_option_chains output is for leg discovery, not direct single-leg execution.
2. Never attempt vanilla single-leg trading via MCP.
3. Always call callput_validate_spread before callput_request_quote.
4. Trade only if:
   • status == "Valid"
   • details.maxTradableQuantity > 0
5. After broadcast, always call callput_check_tx_status.
6. If cancelled, refresh legs and repeat validation.
7. For existing positions:
   • pre-expiry: callput_close_position
   • expired: callput_settle_position
8. Never expose private keys in MCP output.
9. Enforce input guards before calls:
   • callput_approve_usdc.amount > 0
   • callput_check_tx_status.tx_hash must be 32-byte hex
   • callput_close_position.address must be valid EVM address
   • callput_close_position.size > 0
   • callput_settle_position is only for expired options
   • callput_get_option_chains.expiry_date must match a listed expiry

Context Overflow Guardrails

1. Do not keep raw chain responses in long conversation memory.
2. Immediately compress tool output into a compact state object and discard raw payload.
3. Keep candidate set small:
   • max 5 candidate spreads per cycle
   • max 6 Greeks lookups per cycle
4. Always filter chain queries as tightly as possible:
   • set underlying_asset
   • set option_type when known
   • set expiry_date once target tenor is chosen
5. Persist only minimal fields across turns:
   • asset, bias, target_expiry
   • candidate_ids (short list)
   • selected_long_leg_id, selected_short_leg_id
   • validation_status, maxTradableQuantity
   • last_tx_hash, last_tx_status
6. During status polling, only store latest status snapshot, not full history.
7. If context window grows, drop historical reasoning and re-bootstrap from the compact state object.