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.
Your agent decides. Toreva executes. Every action receipted.
Use toreva_establish before perps execution when an agent needs delegated
authority for a human wallet. The standard perps pattern is:
human wallet
-> Toreva/Swig master authority
-> venue-specific child capability
-> Pacifica API agent wallet when Pacifica is selected
The human wallet remains the root owner. The Swig authority is the policy and capital-management control layer. Pacifica uses a separate API agent wallet because Pacifica REST orders require an on-curve Ed25519 signer. Toreva can create, bind, fund, route, monitor, and revoke that child capability through Toreva surfaces; the user does not need to open Pacifica.
For best execution, omit venue on toreva_perps_long or
toreva_perps_short. Toreva will compare enabled venues and route by estimated
all-in cost. Set venue only when you intentionally want a specific venue.
Perps tools use the Gateway MCP field contract: walletAddress, token,
sizeUsd, leverage, collateralToken, and collateralAmount.
The public integration packet lives in this repo:
The fastest path — wires Toreva into your MCP-aware client (Claude Desktop, OpenClaw, Cursor) and authenticates you in two commands:
npx toreva init --client=claude-desktop # or openclaw | cursor
npx toreva logintoreva init writes the Toreva MCP server stanza into your client's
config file. toreva login runs the gateway's device-code flow and
stores the resulting token at ~/.config/toreva/config.json (chmod
600).
Restart your MCP client and verify:
npx toreva doctorYou should see three [ OK ] lines: config_present, auth_token,
mcp_call.
Per-client snippets live in examples/ — one folder per
supported client (claude-desktop, openclaw, cursor).
npm install @toreva/sdk # TypeScript client library
npm install -g @toreva/cli # global `toreva` binaryTOREVA_AUTH_TOKEN=your_token npx @toreva/mcphttps://mcp.toreva.com
toreva login is the standard path. For CI / power users, set
TOREVA_AUTH_TOKEN directly to skip the device-code flow:
export TOREVA_AUTH_TOKEN=your_token
npx toreva login # writes the token to ~/.config/toreva/config.jsonUse toreva login for the standard device-code flow, or request an integration
token from your Toreva contact. The Kit repository is the public source of
truth for agent, SDK, CLI, Skills, and MCP integration details.
| Var | Default | Purpose |
|---|---|---|
TOREVA_MCP_URL |
https://mcp.toreva.com |
Gateway URL |
TOREVA_AUTH_TOKEN |
— | Skip device-code flow, persist this token |
TOREVA_CONFIG_DIR |
~/.config/toreva |
Override on-disk config dir |
| Tool | Fee | What it does |
|---|---|---|
toreva_perps_long |
1 bps | Open long — routes to better fill |
toreva_perps_short |
1 bps | Open short — routes to better fill |
toreva_perps_close |
Free | Close position at venue |
toreva_perps_add_margin |
Free | Add margin |
toreva_perps_remove_margin |
Free | Remove margin |
toreva_perps_cancel_order |
Free | Cancel order |
toreva_perps_funding_settle |
Free | Settle funding |
toreva_perps_simulate |
Free | Preview before execution |
toreva_perps_explain |
Free | Explain trade or position |
toreva_perps_query_* |
Free | Position, funding, venues, markets |
| Venue | Fee | Model |
|---|---|---|
| Jupiter Perps | 6.0 bps flat | Oracle-based |
| Pacifica | 4.0 bps (Tier 1) | Order book variant |
| Drift Protocol | 3.5 bps taker | Order book |
| Flash Trade | 4.0 bps (Tier 1) | Order book variant |
Trades routed to Drift via toreva receive a 5% fee discount.
| Tool | What it does |
|---|---|
toreva_strategies |
Browse strategy catalog with pricing |
toreva_establish |
Attach a delegated agent authority and child capabilities to a wallet |
toreva_earn |
Deploy USDC to yield across venues |
toreva_scan |
Survey portfolio state |
toreva_simulate |
Dry-run without execution |
toreva_execute |
Execute a strategy |
toreva_explain |
Narrate what happened |
toreva_configure |
Adjust settings |
| Package | What |
|---|---|
@toreva/sdk |
TypeScript client library |
@toreva/cli |
Command-line interface |
@toreva/mcp |
MCP server for agent integration |
@toreva/types |
Shared schemas and types |
This software provides tooling for interacting with the toreva execution service. It does not provide financial advice, investment advice, trading advice, or any other form of advice. Use of this software does not create a fiduciary relationship, advisory relationship, or any other professional relationship between you and Toreva Pty Ltd.
Toreva Pty Ltd is not responsible for any modifications made to this software by third parties, including modifications that alter or remove compliance language, disclaimers, or risk warnings. If you use a modified version of this software, you do so at your own risk and are responsible for ensuring your use complies with applicable law.
MIT — see LICENSE