# onestop

> onestop is a free MCP server for finance and payments. Place gasless Solana swaps and chained limit, trailing and TWAP orders from an agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI
- **Website:** https://onestop.trade
- **Repository:** https://github.com/onestop-labs/onestop-mcp
- **MCP Registry name:** trade.onestop/onestop-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Onestop's main idea is the plan: one order that chains an entry, a trailing stop and an exit, with targets set in market cap or as a multiple of entry. An engine watches the market and arms each stage, while your agent signs each fill, so the agent has to stay running or the fill happens later at the then-current price.

The wallet key stays on your machine, supplied as a private key or keypair file, and transactions are simulated against your RPC before signing. Swaps are gasless, with network cost and any fee taken from the trade. Dry-run mode answers without calling onestop, and paper orders rehearse a plan on real prices without signing anything.

Order tools cover limit, trailing, limit-then-trail and TWAP, with list, get, cancel and extend. This moves real funds, so use a wallet kept for trading.

## Features

- **Plans:** Chains an entry buy and a protective or take-profit exit.
- **Market-cap orders:** Limit, trailing, limit-then-trail and TWAP orders.
- **Gasless swaps:** Network cost is taken from the trade, so no SOL is needed.
- **Local key:** The wallet private key stays on your machine.
- **Paper mode:** Rehearse orders on real prices with nothing signed.
- **Pre-sign simulation:** Transactions are simulated through your RPC.

## Good for

- Buy a token on a dip at a set market cap
- Trail a position and sell in slices
- Rehearse a trading plan on paper
- Review signed and refused fills in the activity log

## Install

### Claude Code (Terminal)

```sh
claude mcp add onestop-mcp --env ONESTOP_PRIVATE_KEY='<ONESTOP_PRIVATE_KEY>' -- npx -y @onestop-trade/onestop-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "onestop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@onestop-trade/onestop-mcp"
      ],
      "env": {
        "ONESTOP_PRIVATE_KEY": "<ONESTOP_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "onestop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@onestop-trade/onestop-mcp"
      ],
      "env": {
        "ONESTOP_PRIVATE_KEY": "<ONESTOP_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "onestop-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@onestop-trade/onestop-mcp"
      ],
      "env": {
        "ONESTOP_PRIVATE_KEY": "<ONESTOP_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "onestop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@onestop-trade/onestop-mcp"
      ],
      "env": {
        "ONESTOP_PRIVATE_KEY": "<ONESTOP_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "onestop-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@onestop-trade/onestop-mcp"
      ],
      "env": {
        "ONESTOP_PRIVATE_KEY": "<ONESTOP_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `wallet`: Show wallet address and link
- `connect`: Wait for the engine login
- `quote`: Price a swap and get the unsigned transaction
- `submit_swap`: Trade a quoted transaction
- `swap`: Quote and trade in one call
- `tokens`: Price, market cap and liquidity
- `holdings`: Balances in USD
- `limit_order`: Place a market-cap limit order
- `trailing_order`: Place a trailing order
- `limit_trailing_order`: Place a limit then trailing order
- `twap_order`: Place a TWAP order
- `list_orders`: List orders
- `get_order`: Get one order
- `cancel_order`: Cancel an order
- `extend_order`: Extend an order
- `place_plan`: Place an entry buy plus protective exit
- `get_plan`: Get a plan
- `cancel_plan`: Cancel a plan
- `activity`: Log of fills signed or refused, paper fills and updates

## FAQ

### Does my key leave my machine?

The site says no. Only your agent signs.

### Do I need SOL for gas?

No. The cost comes out of the trade.

### Is there a fee?

The site says no trading fee for now.

### Can I test without trading?

Yes, with ONESTOP_DRY_RUN or paper: true.

### Is onestop free?

Yes. onestop is free to use.

### How do I add onestop to Claude Code?

Run this command in your terminal: claude mcp add onestop-mcp --env ONESTOP_PRIVATE_KEY='<ONESTOP_PRIVATE_KEY>' -- npx -y @onestop-trade/onestop-mcp

### What are the best alternatives to onestop?

The closest alternatives to onestop are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/onestop
