Summary
Wires Claude or your MCP client into Toreva's non-custodial perps execution layer on Solana. Opens longs and shorts at 1 basis point, routes across Jupiter Perps, Pacifica, Drift, and Flash Trade for best execution. Everything after the open is free: closes, margin adjustments, cancels, funding settlement. Uses a delegated authority model so your wallet stays root owner while a Swig policy layer and venue-specific child capabilities handle execution. Includes simulate, explain, and query tools for positions and funding rates. Install with npx toreva init, authenticate with device flow, and let the agent decide while Toreva routes and receipts each action.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
29 tools
KIT_ADD_SUBSCRIBER_TO_FORMTool to add a subscriber to a specific form by ID. Use after confirming form and subscriber IDs.3 params
Tool to add a subscriber to a specific form by ID. Use after confirming form and subscriber IDs.
Parameters* required
idintegerThe ID of the subscriber to add to the form.
form_idintegerThe ID of the form to which the subscriber will be added.
referrerstringThe URL from which the subscriber was referred.
KIT_CREATE_CUSTOM_FIELDTool to create a new custom field for subscriber data. Use when you need to store extra attributes for subscribers.1 params
Tool to create a new custom field for subscriber data. Use when you need to store extra attributes for subscribers.
Parameters* required
labelstringThe display label for the custom field (e.g., 'Favorite Color').
KIT_CREATE_TAGTool to create a new tag in the account. Use when you need a custom label to segment subscribers. Use after confirming tag uniqueness to avoid duplicates. Example: "Create a tag called 'VIP' for premium customers."1 params
Tool to create a new tag in the account. Use when you need a custom label to segment subscribers. Use after confirming tag uniqueness to avoid duplicates. Example: "Create a tag called 'VIP' for premium customers."
Parameters* required
namestringName of the tag to be created.
KIT_CREATE_WEBHOOKTool to create a new webhook subscription. Use when you need subscriber or purchase event notifications.2 params
Tool to create a new webhook subscription. Use when you need subscriber or purchase event notifications.
Parameters* required
eventobjectWebhook event configuration.
target_urlstringURL to receive webhook POST notifications.
KIT_DELETE_BROADCASTTool to delete a specific broadcast. Use when you need to permanently remove a broadcast by ID (after confirming the ID). Example prompt: "Delete broadcast with ID 123"1 params
Tool to delete a specific broadcast. Use when you need to permanently remove a broadcast by ID (after confirming the ID). Example prompt: "Delete broadcast with ID 123"
Parameters* required
idintegerUnique identifier of the broadcast to delete
KIT_DELETE_CUSTOM_FIELDTool to delete a specific custom field. Use after confirming the custom field ID is correct. Deletes the field permanently.1 params
Tool to delete a specific custom field. Use after confirming the custom field ID is correct. Deletes the field permanently.
Parameters* required
idintegerUnique identifier of the custom field to delete
KIT_DELETE_SUBSCRIBERTool to delete (unsubscribe) a subscriber by ID. Use when you need to remove a subscriber from all sequences and forms after confirming the subscriber exists.1 params
Tool to delete (unsubscribe) a subscriber by ID. Use when you need to remove a subscriber from all sequences and forms after confirming the subscriber exists.
Parameters* required
idintegerUnique identifier of the subscriber to delete
KIT_DELETE_TAGTool to delete a tag by ID. Use when you need to remove obsolete or incorrect tags after confirming the tag exists.1 params
Tool to delete a tag by ID. Use when you need to remove obsolete or incorrect tags after confirming the tag exists.
Parameters* required
idintegerUnique identifier of the tag to delete
KIT_DELETE_WEBHOOKTool to delete a webhook by ID. Use when you want to permanently remove a webhook after confirming its ID.1 params
Tool to delete a webhook by ID. Use when you want to permanently remove a webhook after confirming its ID.
Parameters* required
idintegerUnique identifier of the webhook to delete
KIT_GET_ACCOUNTTool to retrieve current account information. Use after validating API key to fetch account ID, plan type, primary email, and timezone details.
Tool to retrieve current account information. Use after validating API key to fetch account ID, plan type, primary email, and timezone details.
No parameter schema in public metadata yet.
KIT_GET_ACCOUNT_COLORSTool to retrieve list of colors associated with the account. Use after confirming authentication to fetch account-specific color palette.
Tool to retrieve list of colors associated with the account. Use after confirming authentication to fetch account-specific color palette.
No parameter schema in public metadata yet.
KIT_GET_BROADCASTTool to retrieve details of a specific broadcast by ID. Use when you have a valid broadcast ID and need its metadata.1 params
Tool to retrieve details of a specific broadcast by ID. Use when you have a valid broadcast ID and need its metadata.
Parameters* required
idintegerUnique identifier of the broadcast to retrieve
KIT_GET_BROADCAST_STATSTool to retrieve statistics for a specific broadcast by ID. Use after a broadcast has been sent to monitor performance.1 params
Tool to retrieve statistics for a specific broadcast by ID. Use after a broadcast has been sent to monitor performance.
Parameters* required
idintegerUnique identifier of the broadcast to fetch statistics for
KIT_GET_CREATOR_PROFILETool to retrieve the creator profile information for the account. Use when you need creator metadata (bio, avatar, social links) before publishing or customizing content.
Tool to retrieve the creator profile information for the account. Use when you need creator metadata (bio, avatar, social links) before publishing or customizing content.
No parameter schema in public metadata yet.
KIT_GET_EMAIL_STATSTool to retrieve email statistics for the account. Use after confirming authentication to fetch metrics on emails (sent, opened, clicked) over the last 90 days.
Tool to retrieve email statistics for the account. Use after confirming authentication to fetch metrics on emails (sent, opened, clicked) over the last 90 days.
No parameter schema in public metadata yet.
KIT_LIST_BROADCASTSTool to retrieve a paginated list of all broadcasts. Use when you need to enumerate or review broadcast summaries with cursor-based pagination.4 params
Tool to retrieve a paginated list of all broadcasts. Use when you need to enumerate or review broadcast summaries with cursor-based pagination.
Parameters* required
afterstringCursor for pagination; returns results after the specified cursor.
beforestringCursor for pagination; returns results before the specified cursor.
per_pageintegerNumber of results per page; must be between 1 and 500.
include_total_countstringIf set to 'true', includes the total count of records in the response.
KIT_LIST_CUSTOM_FIELDSTool to retrieve a paginated list of custom fields. Use after confirming you need to enumerate or inspect all custom fields with cursor-based pagination.4 params
Tool to retrieve a paginated list of custom fields. Use after confirming you need to enumerate or inspect all custom fields with cursor-based pagination.
Parameters* required
afterstringCursor for pagination; returns results after the specified cursor.
beforestringCursor for pagination; returns results before the specified cursor.
per_pageintegerNumber of results per page; defaults to 500 if not specified.
include_total_countstringIf set to 'true', includes the total count of records in the response.
KIT_LIST_FORMSTool to list all forms. Use when you need to fetch forms with optional filters and pagination.6 params
Tool to list all forms. Use when you need to fetch forms with optional filters and pagination.
Parameters* required
typestringFilter forms by type.one of
embed · hostedafterstringCursor for pagination; returns results after the specified cursor.
beforestringCursor for pagination; returns results before the specified cursor.
statusstringFilter forms by status (e.g., 'active', 'archived').
per_pageintegerNumber of forms to return per page.
include_total_countstringIf set to 'true', includes the total count of forms in the response.one of
true · falseKIT_LIST_SEGMENTSTool to retrieve a paginated list of segments. Use when you need to enumerate segments with cursor-based pagination for further processing or display.4 params
Tool to retrieve a paginated list of segments. Use when you need to enumerate segments with cursor-based pagination for further processing or display.
Parameters* required
afterstringCursor for pagination; returns results after this cursor.
beforestringCursor for pagination; returns results before this cursor.
per_pageintegerNumber of segments to return per page (min 1).
include_total_countstringIf set to 'true', includes the total count of segments in the response.one of
true · falseKIT_LIST_SEQUENCESTool to retrieve a paginated list of all sequences. Use when you need to enumerate sequences with pagination for further processing or display.4 params
Tool to retrieve a paginated list of all sequences. Use when you need to enumerate sequences with pagination for further processing or display.
Parameters* required
afterstringCursor for pagination; returns results after the specified cursor.
beforestringCursor for pagination; returns results before the specified cursor.
per_pageintegerNumber of results per page (max 500).
include_total_countstringIf set to 'true', includes the total count in the pagination.one of
true · falseKIT_LIST_SUBSCRIBERSTool to retrieve a list of subscribers. Use when you need to fetch subscriber records with optional filtering, sorting, and pagination.12 params
Tool to retrieve a list of subscribers. Use when you need to fetch subscriber records with optional filtering, sorting, and pagination.
Parameters* required
afterstringCursor for pagination; returns subscribers after this cursor.
beforestringCursor for pagination; returns subscribers before this cursor.
statusstringFilter by subscriber status (e.g., 'active' or 'inactive').
per_pageintegerNumber of subscribers to return per page (min 1).
sort_fieldstringField by which to sort the subscribers.
sort_orderstringOrder in which to sort the results.one of
asc · desccreated_afterstringFilter to subscribers created after this date (YYYY-MM-DD).
email_addressstringExact email address to filter by.
updated_afterstringFilter to subscribers updated after this date (YYYY-MM-DD).
created_beforestringFilter to subscribers created before this date (YYYY-MM-DD).
updated_beforestringFilter to subscribers updated before this date (YYYY-MM-DD).
include_total_countstringIf set to 'true', includes the total count of subscribers in the response.one of
true · falseKIT_LIST_SUBSCRIBERS_FOR_FORMTool to retrieve subscribers for a specific form by ID. Use when you need to page or filter subscribers of a form.10 params
Tool to retrieve subscribers for a specific form by ID. Use when you need to page or filter subscribers of a form.
Parameters* required
afterstringCursor for pagination; returns results after this cursor.
beforestringCursor for pagination; returns results before this cursor.
statusstringFilter subscribers by status (e.g., 'active').
form_idintegerID of the form whose subscribers you want to retrieve.
per_pageintegerNumber of results to return per page (min 1).
added_afterstringReturn subscribers added to the form after this date/time (ISO 8601).
added_beforestringReturn subscribers added to the form before this date/time (ISO 8601).
created_afterstringReturn subscribers created after this date/time (ISO 8601).
created_beforestringReturn subscribers created before this date/time (ISO 8601).
include_total_countstringIf 'true', includes the total count of subscribers in the response.one of
true · falseKIT_LIST_TAGSTool to retrieve a list of all tags. Use when you need a complete inventory of tags for the Kit account.
Tool to retrieve a list of all tags. Use when you need a complete inventory of tags for the Kit account.
No parameter schema in public metadata yet.
KIT_LIST_TAG_SUBSCRIBERSTool to retrieve subscribers for a specific tag. Use after confirming the tag ID when you need to list subscribers associated with a tag.10 params
Tool to retrieve subscribers for a specific tag. Use after confirming the tag ID when you need to list subscribers associated with a tag.
Parameters* required
afterstringCursor for pagination; returns subscribers after this cursor.
beforestringCursor for pagination; returns subscribers before this cursor.
statusstringFilter by subscriber status ('active' or 'inactive').
tag_idintegerUnique identifier of the tag to retrieve subscribers for
per_pageintegerNumber of subscribers to return per page (min 1).
tagged_afterstringFilter to subscribers tagged after this timestamp (ISO 8601).
created_afterstringFilter to subscribers created after this timestamp (ISO 8601).
tagged_beforestringFilter to subscribers tagged before this timestamp (ISO 8601).
created_beforestringFilter to subscribers created before this timestamp (ISO 8601).
include_total_countstringIf set to 'true', includes total count of subscribers in the response.one of
true · falseKIT_TAG_SUBSCRIBERTool to associate a subscriber with a specific tag by ID. Use after confirming tag and subscriber IDs when tagging a subscriber.2 params
Tool to associate a subscriber with a specific tag by ID. Use after confirming tag and subscriber IDs when tagging a subscriber.
Parameters* required
tag_idintegerID of the tag to assign
subscriber_idintegerID of the subscriber to tag
KIT_TAG_SUBSCRIBER_BY_EMAILTool to associate a subscriber with a tag using an email address. Use when you have a tag ID and subscriber email ready. Use after confirming both resources exist.2 params
Tool to associate a subscriber with a tag using an email address. Use when you have a tag ID and subscriber email ready. Use after confirming both resources exist.
Parameters* required
tag_idintegerThe ID of the tag to assign to the subscriber
email_addressstringThe subscriber's email address
KIT_UPDATE_ACCOUNT_COLORSTool to update the list of colors for the account. Use when customizing your Kit account's color palette for broadcasts and templates.1 params
Tool to update the list of colors for the account. Use when customizing your Kit account's color palette for broadcasts and templates.
Parameters* required
colorsarrayList of hex color codes to set for the account (e.g., '#008000', '#FF0000').
KIT_UPDATE_CUSTOM_FIELDTool to update a custom field's label. Use after listing or retrieving custom fields and confirming the field ID to rename.2 params
Tool to update a custom field's label. Use after listing or retrieving custom fields and confirming the field ID to rename.
Parameters* required
idintegerUnique identifier of the custom field to update
labelstringNew label for the custom field
KIT_UPDATE_TAGTool to update a tag's name by ID. Use after retrieving tag ID and confirming the new name.2 params
Tool to update a tag's name by ID. Use after retrieving tag ID and confirming the new name.
Parameters* required
idintegerUnique identifier of the tag to update
namestringNew name for the tag
toreva kit
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.
Establish your wallet
Use toreva_establish to attach a policy-controlled delegated authority to
your Solana wallet. Your wallet stays the root owner — Toreva creates a bounded
session key that enforces spend caps, allowed-token constraints, and revocation
policy. Non-custodial: Toreva never holds private key material. Every
establishment is receipted.
# Minimum — attach delegated authority to your wallet
toreva_establish({ walletAddress: "your-wallet-address" })
Once established, your agent can execute across all supported primitives — earn, perps, and more — without re-authenticating for each operation.
Earn
Deploy idle USDC to yield across supported venues with toreva_earn. Scan,
compare, and execute from a single tool.
npx toreva earn-compare --asset USDC --venue kamino
npx toreva earn-compare --asset USDC --venue marginfi
| Venue | Asset |
|---|---|
| Kamino Finance | USDC |
| Marginfi | USDC |
Every earn execution returns a read-evidence receipt, a venue-intelligence receipt, and a sentinel review receipt.
Install
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 login
toreva 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 doctor
You 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).
Direct package installs (advanced)
npm install @toreva/sdk # TypeScript client library
npm install -g @toreva/cli # global `toreva` binary
MCP server (stdio, run-it-yourself)
TOREVA_AUTH_TOKEN=your_token npx @toreva/mcp
MCP server (remote, no install)
https://mcp.toreva.com
Authentication
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.json
Use 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.
Environment variables
| 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 |
Perps tools
Run toreva_establish first to attach a delegated authority before execution.
For best fill, omit venue — Toreva compares enabled venues and routes by
estimated all-in cost. Set venue only when you intentionally want a specific
venue. Perps tools use fields: walletAddress, token, sizeUsd, leverage,
collateralToken, and collateralAmount.
The public integration packet lives in this repo:
| 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 |
Venues
| 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.
Strategy tools
| 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 |
Packages
| 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 |
Regulatory notice
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.
License
MIT — see LICENSE
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Categories
Registryactive
Package@toreva/mcp
TransportSTDIO, HTTP
UpdatedApr 1, 2026
