Back to Browse

Onestop MCP Server

Developer ToolsModerate6.8MCP RegistryLocal
Free

Server data from the Official MCP Registry

Gasless Solana swaps, market-cap limit, trailing and TWAP orders, and plans. Your key stays local.

About

Gasless Solana swaps, market-cap limit, trailing and TWAP orders, and plans. Your key stays local.

Security Report

6.8
Moderate6.8Moderate Risk

The onestop MCP is a Solana trading server that requires a wallet private key, verifies every engine message with a built-in Ed25519 engine key, and runs a pre-sign transaction guard that simulates each transaction on the user's RPC before signing. Its network and wallet-signing permissions match its trading purpose, and the main residual concerns are that it holds a live private key with signing authority and depends on a built-in trust anchor and a hosted engine that the user cannot independently verify. Code quality is reasonable, with minor notes on fail-open behavior from the SKIP_SPEND_CHECK option and reliance on the public default RPC. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

6 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

network_websocket

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

Check that this permission is expected for this type of plugin.

database

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

The private key of the wallet that trades, as your wallet exports it. Use a wallet you keep for tradingRequired

Environment variable: ONESTOP_PRIVATE_KEY

Or the path to a keypair file, instead of the private keyOptional

Environment variable: ONESTOP_KEYPAIR_PATH

Your RPC, used to simulate every transaction before signing (default: public mainnet)Optional

Environment variable: SOLANA_RPC_URL

true to trade nothing: order tools answer without calling onestop and swaps stop after the guardOptional

Environment variable: ONESTOP_DRY_RUN

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "trade-onestop-onestop-mcp": {
      "env": {
        "SOLANA_RPC_URL": "your-solana-rpc-url-here",
        "ONESTOP_DRY_RUN": "your-onestop-dry-run-here",
        "ONESTOP_PRIVATE_KEY": "your-onestop-private-key-here",
        "ONESTOP_KEYPAIR_PATH": "your-onestop-keypair-path-here"
      },
      "args": [
        "-y",
        "@onestop-trade/onestop-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

onestop MCP

Lets an AI agent trade Solana tokens through onestop: gasless swaps (no SOL needed; the network cost and any fee are taken from the trade), market-cap orders (limit, trailing, limit then trail, TWAP) and plans that buy and then protect the position. Your wallet's key stays on your machine.

{ "mcpServers": { "onestop": { "command": "npx", "args": ["-y", "@onestop-trade/onestop-mcp"],
    "env": { "ONESTOP_PRIVATE_KEY": "your-wallet-private-key" } } } }

Node 20.18 or later.

Setting
ONESTOP_PRIVATE_KEY or ONESTOP_KEYPAIR_PATHthe wallet that trades: its private key as your wallet exports it (Phantom: Settings → your account → Show private key), or the path to a keypair file. Use a wallet you keep for trading
SOLANA_RPC_URLyour RPC, used to simulate every transaction before signing (default: public mainnet)
ONESTOP_DRY_RUN=1trade nothing: order and plan tools answer without calling onestop, and swaps stop after the guard. Paper orders still run
ONESTOP_SKIP_SPEND_CHECK=1turn off the guard's balance checks (the structural checks stay). For debugging only
ONESTOP_STATEwhere the MCP keeps the orders and plans it placed (default ~/.onestop-mcp/<wallet>.json)
ONESTOP_API_URL, ONESTOP_SERVER_PUBKEY (+ _NEXT)for a self-hosted engine: its URL, its signing key

Tools

Amounts are raw units (lamports for SOL); levels and shares are basis points (20000 = 2x, 10000 = all).

Walletwallet (address and link, no network call), connect (wait for the engine login)
Swapsquote (price it, get the unsigned transaction), submit_swap (trade a quoted transaction), swap (both in one call)
Market datatokens (price, market cap, liquidity), holdings (balances in USD)
Orderslimit_order, trailing_order, limit_trailing_order, twap_order; each but the TWAP can also fill in slices. list_orders, get_order, cancel_order, extend_order
Plansplace_plan (an entry buy, then a protect or take-profit exit for exactly what it bought), get_plan, cancel_plan
Logactivity: fills signed or refused (and why), paper fills, order and plan updates

paper: true on an order or plan rehearses it with real prices: fills are priced from the route and recorded, and nothing is signed or traded.

What it signs

Every message from onestop must carry onestop's engine signature. A fill is signed only for an order this MCP placed, after checking onestop committed to exactly what was asked, or for the exit of one of its plans, selling no more than the entry bought. Before signing, the transaction is simulated on your RPC and checked: onestop's gas wallet pays the fee and your wallet is the only other signer; your SOL can't fall by more than the quote says; no token balance falls except the one you're selling, by at most the amount; the output arrives; no approvals, authority changes or account reassignment; nothing closes an account you already had.

It has to be running

onestop watches the market 24/7, but this MCP signs each fill, so it needs to be running: if it's closed when an order fires, the fill waits and runs when it's back, at the price then.

Reviews

No reviews yet

Be the first to review this server!