options_trading_base

This repository hosts the Callput Agent MCP package for external AI agents.

Package

• callput-agent-mcp: MCP server for spread-only options execution on Base L2.

OpenClaw External Agent Quick Start

1) Clone and build

git clone https://github.com/ayggdrasil/options_trading_base.git
cd options_trading_base/callput-agent-mcp
npm install
npm run build
npm run verify:core

2) Set runtime paths (required)

• mcp_dir: absolute local path to callput-agent-mcp
• mcp_entry: <mcp_dir>/build/index.js

Important:

• Use a real absolute path at runtime.
• Do not keep placeholders like <mcp_dir> or <mcp_entry> in agent config.
• Prefer paths without spaces.

3) Configure OpenClaw MCP

Use the same MCP config format your runtime expects. Core values:

{
  "mcpServers": {
    "callput": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/callput-agent-mcp/build/index.js"],
      "env": {
        "RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}

4) Load OpenClaw policy block

Use:

• callput-agent-mcp/OPENCLAW_SYSTEM_PROMPT.md

5) Minimal tool loop (required)

1. callput_get_agent_bootstrap
2. callput_get_available_assets / callput_get_market_trends
3. callput_get_option_chains
4. callput_validate_spread
5. callput_request_quote
6. callput_check_tx_status
7. callput_close_position (pre-expiry) or callput_settle_position (post-expiry)

Required execution rules

• Spread-only execution.
• Never execute single-leg vanilla directly.
• Validate before quote.
• Proceed only when validation is Valid and maxTradableQuantity > 0.
• If tx status is cancelled, refresh legs and re-validate before re-quote.

Full docs

• callput-agent-mcp/README.md
• callput-agent-mcp/EXTERNAL_AGENT_GUIDE.md
• callput-agent-mcp/MCP_SETUP.md
• callput-agent-mcp/SKILL.md