# toreva

Non-custodial execution primitives for Solana. Best-execution routing across Jupiter Perps, Pacifica, Drift, and Flash Trade. 1 bps to open. Everything else is free.

## Public source of truth

Toreva Kit is the public SDK, CLI, MCP, Skills, and API contract surface.

- Repository: https://github.com/toreva/kit
- Agentic perps integration patterns: https://github.com/toreva/kit/blob/main/docs/agentic-perps-integration-patterns.md
- OpenAPI-style relay examples: https://github.com/toreva/kit/blob/main/docs/toreva-perps.openapi.json
- Claude Code agent prompt: https://github.com/toreva/kit/blob/main/docs/claude-code-agent-prompt.md
- Agentic perps workflow example: https://github.com/toreva/kit/tree/main/examples/agentic-perps-workflow
- Skills: https://github.com/toreva/kit/tree/main/skills

## Public developer entry points

- Install: `npx @smithery/cli install toreva/toreva`
- MCP registry lookup: https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.toreva/kit
- Smithery server: https://smithery.ai/servers/toreva/toreva
- Gateway MCP (Streamable HTTP; requires bearer token and MCP headers): https://gateway.toreva.com/mcp
- Website MCP manifest: https://toreva.com/.well-known/mcp.json
- Website OpenAPI: https://toreva.com/.well-known/openapi.json

## Key tools

- `toreva_establish` / `toreva_perps_establish` — establish delegated authority and perps child capability
- `toreva_perps_query_venues` — list available perps venues
- `toreva_perps_simulate` — preview without execution
- `toreva_perps_long` — open long perps position
- `toreva_perps_short` — open short perps position
- `toreva_perps_close` — close a perps position
- `toreva_perps_cancel_order` — cancel an open perps order
- `toreva_perps_funding_settle` — settle funding

Execution only — not financial advice. Never request raw private keys, seed phrases, API secrets, or signer material.