toreva_configure
Configure preferences for toreva execution. Set default constraints, preferred protocols, and risk tolerance.
LABSCO SUMMARY
Simulation is free and separate, which is the habit the whole tool set is shaped around.
toreva_simulate and toreva_perps_simulate cost nothing and execute nothing — they return the projected entry, the fees, the funding cost and the venue comparison a live order would have used, which makes the sensible pattern obvious: simulate, read the venue reasoning, then open. On pricing, only opening a perps position carries a Toreva fee, at 1 bps of notional, while closing, margin changes, cancellations, funding settlement and every read are free. Execution stays non-custodial, with the transaction handed back for signing and a receipt afterwards, so what an agent can do here is propose and prepare rather than move funds on its own.
What it is
An MCP server for Toreva, which turns Solana DeFi actions into tools an agent can call: scan a wallet, simulate what a strategy would do, execute it as a user-signable transaction, and read back a receipt for what happened. Alongside that sits a perpetual-futures layer that compares Jupiter Perps, Pacifica, Drift and Flash Trade on fees, funding rate and liquidity before routing an order.
What you get
- toreva_scan finds idle capital, yield opportunities and risk flags in a wallet, returning recommendations ranked by expected return
- toreva_simulate previews a strategy's projected returns, fees, venue selection and risk before anything commits; toreva_execute runs it; toreva_explain reconstructs an intent, receipt or strategy in plain language, including why a venue was chosen
- toreva_earn deploys idle USDC into the highest-yielding lending strategy it can verify, risk-ranked across Kamino, Marginfi and Drift; toreva_strategies browses the catalogue with risk labels and pricing tiers; toreva_configure holds default constraints, preferred protocols and risk tolerance
- toreva_perps_simulate compares all four venues on fees, funding rate and liquidity and returns a projected entry price — free, with no execution and no fee
- toreva_perps_long and toreva_perps_short open positions with that routing at 1 bps of notional, and trades routed to Drift take a 5% fee discount against going direct
- Managing a position carries no Toreva fee at all: toreva_perps_close, toreva_perps_add_margin, toreva_perps_remove_margin, toreva_perps_cancel_order and toreva_perps_funding_settle each execute at the position's own venue
- The read side is free too: toreva_perps_query_position, toreva_perps_query_funding across the four venues, toreva_perps_query_venues with their fee structures, and toreva_perps_query_markets
- toreva_perps_explain returns the venue used, entry price, fees paid, funding rate at entry, live P&L if the position is open, and the reason that venue was selected
Requirements
npm install -g @toreva/mcp, then run toreva-mcp over stdio with RELAY_AUTH_TOKEN set. Execution is non-custodial: transactions are prepared for you to sign, and every action returns a receipt. The publisher states that this software provides no financial, investment or trading advice and creates no advisory or fiduciary relationship.
Setup effort
One command plus a key — npm install -g @toreva/mcp, then supply credentials
USE CASES
01
Finding out what a wallet is doing nothing with
Idle capital, available yield and risk flags in one scan, with the recommendations ordered by expected return rather than by protocol.
02
Putting stablecoins to work without picking a venue by hand
Idle USDC deployed into the best verified lending rate across Kamino, Marginfi and Drift, previewed with fees before the transaction is prepared.
03
Checking what a trade would cost before opening it
The four venues compared on fees, funding rate and liquidity, with a projected entry price — and no fee for asking.
04
Opening a position at the better fill
Direction, size and leverage are yours; the routing across Jupiter Perps, Pacifica, Drift and Flash Trade is handled, at 1 bps of notional.
05
Managing a position you already hold
Add or remove margin, cancel an order, settle funding or close — each executing at that position's venue with no Toreva fee.
06
Understanding what an agent just did with your money
The venue used, the entry price, the fees paid, the funding rate at entry and why that venue was picked — read back after the fact from the receipt.
20 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
toreva_earn
Deploy idle USDC to the highest-yield DeFi lending strategy on Solana. Risk-ranked across verified venues (Kamino, Marginfi, Drift). Scan, simulate projected returns with fees, and execute via user-signable transaction. Non-custodial. Every action receipted.
toreva_execute
Execute a strategy on Solana. Supports earning yield on USDC, staking SOL, rebalancing portfolios, and more. Non-custodial. Every action receipted.
toreva_explain
Explain an existing intent, receipt, or strategy in plain language. Provides breakdown of what happened, fees charged, and reasoning behind venue selection.
toreva_perps_add_margin
Add margin to a perpetual futures position. Executes at the position's venue. Free — no Toreva fee. Non-custodial.
toreva_perps_cancel_order
Cancel an open perpetual futures order. Executes at the position's venue. Free — no Toreva fee. Non-custodial.
toreva_perps_close
Close a perpetual futures position. Executes at the position's venue. Free — no Toreva fee. Non-custodial. Execution only.
toreva_perps_explain
Explain a perpetual futures position or trade. Returns venue used, entry price, fees paid, funding rate at entry, current P&L if open, and why the venue was selected. Free. Use after execution to understand what happened and why.
toreva_perps_funding_settle
Settle funding payments on a perpetual futures position. Executes at the position's venue. Free — no Toreva fee. Non-custodial.
toreva_perps_long
Open a long perpetual futures position on Solana. Routes to better execution across Jupiter Perps, Pacifica, Drift, and Flash Trade — compares fees, funding rate, and available liquidity, then routes to whichever venue offers a better fill. 1 bps execution fee on notional. Trades routed to Drift receive a 5% fee discount vs going direct. Your agent decides direction, size, and leverage. Toreva handles venue selection and transaction construction. Non-custodial. Every execution receipted. Execution only — not financial advice.
toreva_perps_query_funding
Query current funding rates across Jupiter Perps, Pacifica, Drift, and Flash Trade for a token. Read-only. Free.
toreva_perps_query_markets
List available perpetual futures markets. Read-only. Free.
toreva_perps_query_position
Query open perpetual futures positions for a wallet. Read-only. Free.
toreva_perps_query_venues
List available perps venues with fee structures. Read-only. Free.
toreva_perps_remove_margin
Remove margin from a perpetual futures position. Executes at the position's venue. Free — no Toreva fee. Non-custodial.
toreva_perps_short
Open a short perpetual futures position on Solana. Routes to better execution across Jupiter Perps, Pacifica, Drift, and Flash Trade. 1 bps execution fee on notional. Trades routed to Drift receive a 5% fee discount vs going direct. Your agent decides direction, size, and leverage. Toreva handles venue selection and transaction construction. Non-custodial. Execution only — not financial advice.
toreva_perps_simulate
Simulate opening a perpetual futures position without executing. Compares Jupiter Perps, Pacifica, Drift, and Flash Trade on fees, funding rate, and liquidity. Returns projected entry price, fees, funding cost, and venue comparison. Free — no execution, no fee. Use before toreva_perps_long or toreva_perps_short to preview what would happen.
toreva_scan
Scan a Solana wallet to find idle capital, yield opportunities, and risk flags. Returns actionable recommendations ranked by expected return. Non-custodial.
toreva_simulate
Simulate execution of a strategy without committing funds. Returns projected returns, fees, venue selection, and risk assessment. Use before toreva_execute to preview what will happen.
toreva_strategies
Browse the toreva strategy catalog. Returns available strategies with descriptions, risk labels, and pricing tiers. Use to discover what toreva can do before executing.
BEFORE YOU INSTALL
What to know first
Tools you get
20 tools when we connected. The seven tools in the documentation's MCP Tools table, such as toreva_establish_agent_wallet, do not exist in @toreva/mcp 0.2.0, which exposes perps-style names such as toreva_perps_long and toreva_simulate instead.
Requires
- npx on PATH
- RELAY_AUTH_TOKEN in your environment
CONTEXT COST
Light Standing cost
Rated by the size of the 20 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"toreva": {
"command": "npx",
"args": [
"-y",
"@toreva/mcp"
]
}
}
}The configuration on this page does not set RELAY_AUTH_TOKEN; the project's instructions put it in a .env file. Check which folder the server reads that file from before you rely on it.
npm
TERMINAL
npm install -g @toreva/mcp
