llms.txt

# bybit-cli

Agent-first CLI for trading crypto on Bybit V5 with structured JSON output, a built-in MCP server, and live trading plus spot and futures paper workflows.

## Start Here

- [CONTEXT.md](CONTEXT.md): Runtime context for tool-using agents
- [AGENTS.md](AGENTS.md): Full integration guide for agent builders
- [CLAUDE.md](CLAUDE.md): Claude-specific guidance

## Machine Contracts

- [agents/tool-catalog.json](agents/tool-catalog.json): Canonical CLI/agent command catalog with parameter metadata, auth requirements, `dangerous` flags, and examples
- [agents/mcp-tool-catalog.json](agents/mcp-tool-catalog.json): Runtime MCP tool catalog generated from the live stdio registry
- [agents/error-catalog.json](agents/error-catalog.json): Error categories, `ret_code` semantics, and retry/remediation guidance

## Workflow Skills

- [skills/](skills/): Goal-oriented `SKILL.md` packages for execution, market monitoring, paper testing, and risk workflows

## Notes

- `agents/tool-catalog.json` is the broad CLI/agent command catalog.
- `agents/mcp-tool-catalog.json` is the parity-checked runtime MCP tool catalog.
- `bybit mcp -s market,trade,paper,futures-paper` starts the built-in MCP server over stdio for direct agent integration.
- Persistent local state is shared across CLI and MCP sessions for saved credentials, the spot paper journal, the futures paper state, shell history, and the anonymous instance ID.
- Users migrating from kraken-cli-style workflows should start with [KRAKEN_COMPAT.md](KRAKEN_COMPAT.md).