Spectra Pt Yield Trader

Workflow Summary

1. •validate_inputs validates chain, size, slippage, and safety caps.
2. •scan_opportunities uses mcp-spectra.scan_opportunities for capital-aware ranking.
3. •select_candidate filters by symbol, liquidity, maturity window, and impact constraints.
4. •quote_trade uses mcp-spectra.quote_trade for executable PT pricing and min-out.
5. •simulate_portfolio uses mcp-spectra.simulate_portfolio_after_trade to preview deltas.
6. •looping_check optionally uses mcp-spectra.get_looping_strategy for PT+Morpho leverage context.
7. •risk_guard enforces notional/slippage limits and blocks unsafe requests.
8. •execution_handoff emits a structured execution intent for a separate signer/executor.

Key Constraint

The Spectra MCP server is read-only. This skill does not sign or broadcast on-chain transactions. live_mode only controls whether the skill emits an execution handoff payload after passing risk gates.

Safety Rules

• •Default mode is dry-run (live_mode=false).
• •Handoff requires both:
  • •inputs.live_mode=true
  • •execution.confirm_live_handoff=true in config
• •Risk caps are enforced before handoff:
  • •policies.max_notional_usd
  • •policies.max_slippage_bps
• •If any guard fails, return a policy block instead of an execution intent.

Tooling

• •Primary connector: mcp-spectra publisher backed by the Spectra MCP server (npx spectra-mcp-server).
• •Optional scheduling connector: seren-cron for periodic scans.
• •Tool reference: references/spectra-mcp-tools.md.

Quick Start

1. •Copy config.example.json to config.json.
2. •Run dry-run planning:
   • •python scripts/agent.py --config config.json
3. •Enable execution handoff only after review:
   • •set inputs.live_mode=true
   • •set execution.confirm_live_handoff=true
   • •run python scripts/agent.py --config config.json

Autonomous Scheduling with seren-cron

1. •Start trigger server:
   • •python scripts/run_agent_server.py --config config.json --port 8080
2. •Create cron job:
   • •python scripts/setup_cron.py create --url http://localhost:8080/run --schedule "*/30 * * * *"
3. •Manage jobs:
   • •python scripts/setup_cron.py list
   • •python scripts/setup_cron.py pause --job-id <job_id>
   • •python scripts/setup_cron.py resume --job-id <job_id>
   • •python scripts/setup_cron.py delete --job-id <job_id>

Each scheduled run executes one full planning cycle:

• •scan opportunities
• •quote candidate PT trade
• •simulate post-trade portfolio
• •emit execution handoff only when enabled by config guards