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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →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
form_idintegerThe ID of the form to which the subscriber will be added.
idintegerThe ID of the subscriber to add to the form.
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.
include_total_countstringIf set to 'true', includes the total count of records in the response.
per_pageintegerNumber of results per page; must be between 1 and 500.
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.
include_total_countstringIf set to 'true', includes the total count of records in the response.
per_pageintegerNumber of results per page; defaults to 500 if not specified.
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
afterstringCursor for pagination; returns results after the specified cursor.
beforestringCursor for pagination; returns results before the specified cursor.
include_total_countstringIf set to 'true', includes the total count of forms in the response.one of
true · falseper_pageintegerNumber of forms to return per page.
statusstringFilter forms by status (e.g., 'active', 'archived').
typestringFilter forms by type.one of
embed · hostedKIT_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.
include_total_countstringIf set to 'true', includes the total count of segments in the response.one of
true · falseper_pageintegerNumber of segments to return per page (min 1).
KIT_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.
include_total_countstringIf set to 'true', includes the total count in the pagination.one of
true · falseper_pageintegerNumber of results per page (max 500).
KIT_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.
created_afterstringFilter to subscribers created after this date (YYYY-MM-DD).
created_beforestringFilter to subscribers created before this date (YYYY-MM-DD).
email_addressstringExact email address to filter by.
include_total_countstringIf set to 'true', includes the total count of subscribers in the response.one of
true · falseper_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 · descstatusstringFilter by subscriber status (e.g., 'active' or 'inactive').
updated_afterstringFilter to subscribers updated after this date (YYYY-MM-DD).
updated_beforestringFilter to subscribers updated before this date (YYYY-MM-DD).
KIT_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
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).
afterstringCursor for pagination; returns results after this cursor.
beforestringCursor for pagination; returns results before this cursor.
created_afterstringReturn subscribers created after this date/time (ISO 8601).
created_beforestringReturn subscribers created before this date/time (ISO 8601).
form_idintegerID of the form whose subscribers you want to retrieve.
include_total_countstringIf 'true', includes the total count of subscribers in the response.one of
true · falseper_pageintegerNumber of results to return per page (min 1).
statusstringFilter subscribers by status (e.g., 'active').
KIT_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.
created_afterstringFilter to subscribers created after 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 · falseper_pageintegerNumber of subscribers to return per page (min 1).
statusstringFilter by subscriber status ('active' or 'inactive').
tag_idintegerUnique identifier of the tag to retrieve subscribers for
tagged_afterstringFilter to subscribers tagged after this timestamp (ISO 8601).
tagged_beforestringFilter to subscribers tagged before this timestamp (ISO 8601).
KIT_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
subscriber_idintegerID of the subscriber to tag
tag_idintegerID of the tag to assign
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
email_addressstringThe subscriber's email address
tag_idintegerThe ID of the tag to assign to the subscriber
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
Kit is the public client layer for connecting user-owned compute to Toreva governed objects.
The front door is the object store. MCP clients, SDK callers, CLI users, and customer-owned agent fleets all read and write the same Toreva objects through the gateway relay, and every accepted, pending, or refused outcome returns a receipt.
GitHub can prove which organization and admin are acting. It is not the transport for Toreva work messages. Compute is bound per scope, and the live paths put model execution on the developer's own account.
No money moves through this connector.
The Three Doors
Door 1: MCP
Use this first. Your AI client connects the Toreva MCP server, your own client subscription does the work, and Toreva receives only the object reads and writes you authorize.
npx toreva init --client=claude-desktop
npx toreva login
npx toreva doctor
Restart the client, then ask it about your Toreva objects or receipts. Supported
client config targets are claude-desktop, cursor, and openclaw.
Door 2: Customer-Owned Fleet
Use this when you need unattended or scheduled agents. A GitHub organization
admin runs agents in their own org, on their own runners, with their own model
credentials. The agents call Toreva through MCP, SDK, or CLI and land answers
back on Toreva objects with receipt_id proof.
Start here: GitHub Org Agent Fleet.
Door 3: Hosted Compute
Hosted compute means Toreva runs the agents and carries the marginal model cost. This door is deferred and is not documented as available. Use MCP or a customer-owned fleet today.
How Answers Land
The object store is the receiving system. A work surface prepares a relay
request, sends it to https://gateway.toreva.com/relay, and treats the result
as accepted only when the gateway returns a receipt_id.
For the shared install, invoke, and receipt shapes, see Work-Surface Connector Primitives.
MCP Tools
| Tool | What it does |
|---|---|
toreva_establish_agent_wallet | Create the agent wallet with hard limits |
toreva_read_or_scan | Read or scan a main wallet or agent wallet |
toreva_simulate_action | Test an action before anything is prepared |
toreva_prepare_unsigned_transaction | Prepare an unsigned transaction after simulation |
toreva_explain_action | Explain an action or receipt |
toreva_get_receipt | Fetch one receipt |
toreva_refuse_action | Refuse an unsafe action and return a refusal receipt |
Install
The local package runs over stdio. Use either the token written by
toreva login or an explicit RELAY_AUTH_TOKEN from your own secret store.
npm install -g @toreva/mcp
toreva login
toreva-mcp
For runner-owned environments:
RELAY_AUTH_TOKEN=your_token toreva-mcp
For local development:
pnpm install
pnpm --filter @toreva/mcp build
RELAY_AUTH_TOKEN=your_token node packages/mcp/dist/index.js
Package
@toreva/mcp is the Rung-1 MCP package. Version 0.2.0 is stdio-local only.
The public metadata is server.json and packages/mcp/package.json.
Packages
| Package | What |
|---|---|
@toreva/mcp | MCP server for agent integration |
@toreva/types | Shared schemas and types |
@toreva/sdk | TypeScript client library |
@toreva/cli | Command-line interface |
Verify
pnpm test
pnpm --filter @toreva/mcp build
Regulatory notice
This software provides tooling for interacting with the Toreva policy 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 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
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Categories
Registryactive
Package@toreva/mcp
TransportSTDIO, HTTP
UpdatedApr 1, 2026
