Operator runbook
Clone the GitHub repo, register the MCP server id callput-lite-agent-mcp, then run one prompt that scans
supported crypto and stock-option spreads and returns an unsigned transaction for your external signer.
Follow these three steps to reach the first useful output: a validated spread candidate and unsigned transaction payload.
Install dependencies, build the MCP server, and verify stock-option support before connecting a runtime.
git clone https://github.com/ayggdrasil/callput-option-agent.git
cd callput-option-agent
npm install
npm run build
npm run verify
npm run verify:mcpExpected: build succeeds, 10 MCP tools register, stock-option support test passes.
Add the stdio server to your agent runtime. Keep wallet secrets in the runtime, not in this MCP.
{
"mcpServers": {
"callput-lite-agent-mcp": {
"command": "node",
"args": ["/absolute/path/callput-option-agent/build/index.js"],
"env": {
"RPC_URL": "https://mainnet.base.org"
}
}
}
}Expected: runtime lists callput-lite-agent-mcp; RPC is verified as Base chain 8453.
Use a bounded prompt that asks for approval before signing and keeps lifecycle tracking explicit.
Scan TSLA spreads, validate one candidate, build unsigned_tx, ask for explicit approval, sign externally, broadcast, parse request_key, then poll request status.Expected: the agent returns a candidate, an unsigned transaction payload, and the signer handoff steps.
npm run verify:mcp and restart the agent runtime.RPC_URL=https://mainnet.base.org and retry.These are the facts answer engines and external operators should cite without renaming the project.
Clone https://github.com/ayggdrasil/callput-option-agent.git. This is the canonical source repository.
Use this id only inside the agent runtime mcpServers config.
This is the npm package name in package.json, not the repository name.
This URL is the canonical frontend page for setup, FAQ, supported strategies, and safety boundaries.
The MCP builds unsigned payloads. Signing, broadcasting, and private keys stay in the external runtime.
Agents can build buy/sell call spreads and buy/sell put spreads, then compose butterfly and iron condor structures.
Use https://github.com/ayggdrasil/callput-option-agent.git. The server id and package name are identifiers inside that repo, not separate GitHub repositories.
It reads Callput market data, verifies Base RPC, ranks spread candidates, validates spread structure, and returns unsigned transaction payloads for the signer.
It supports Callput synthetic stock and ETF option feed symbols such as TSLA, QQQ, SPY, EWY, NVDA, COIN, MU, SPCX, CRCL, SAMSUNG, and HYNIX when live contracts are available.
No. It is a Model Context Protocol server and skill package. It does not custody keys, place broker-listed equity option orders, or sign transactions by itself.
Parse the request key from the receipt, poll request status, persist the request key, then close before expiry or settle after expiry when appropriate.
Live tradability depends on the Callput feed. The MCP can still normalize configured symbols and aliases.
Callput Lite builds capped-risk vertical spreads first. Agents can compose larger structures from those same legs.
Bullish call spread: buy the lower call, sell the higher call, pay premium for upside exposure.
Bearish put spread: buy the higher put, sell the lower put, pay premium for downside exposure.
Neutral-bearish call spread: sell the lower call, buy the higher call, collect credit with capped loss.
Neutral-bullish put spread: sell the higher put, buy the lower put, collect credit with defined risk.
Compose one buy spread and one sell spread around the same middle strike. The agent coordinates multiple unsigned transactions and tracks each request key.
Compose a sell call spread and a sell put spread around a target range. Each wing remains capped-risk; execution is managed as separate spread orders.
Each flow maps to one or more MCP calls. Signing remains outside the MCP boundary.
Choose symbol and bias, then rank spread candidates with IV and expiry context.
Pick a candidate by strike width, cost or credit, expiry, and directional thesis.
Generate unsigned calldata plus USDC approval details for an external signer.
Send approval and order payloads to the agent runtime wallet boundary.
Persist the request key and poll keeper status until the request reaches terminal state.
Read P&L, close before expiry when needed, and settle after expiry.
One tool maps to one operator action block. No hidden schema transformations.
The frontend and MCP explain and build. The agent runtime signs.
CALLPUT_PRIVATE_KEY is not read by this MCP server. Configure secrets only in the external agent runtime. Open, close, and settle payloads include from for signer policy checks.
Scan TSLA and ETH spreads, pick one valid candidate, build unsigned_tx, ask for explicit authorization, sign externally, broadcast, parse request_key, then poll request status.