# onestop

This MCP server for Claude Code places Solana token swaps and manages orders through onestop. It can also create plans that buy a token and set an exit.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: OneStop-Labs
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/OneStop-Labs/onestop-mcp
- Updated: 2026-11-03
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/onestop

## What it does

onestop connects an agent to Solana token trading. It can fetch a quote, submit a swap, read token and wallet data, and place limit, trailing, or TWAP orders. A plan can make an entry purchase and arrange a protective or profit-taking exit.

Run it with Node 20.18 or later and provide a wallet through `ONESTOP_PRIVATE_KEY` or `ONESTOP_KEYPAIR_PATH`. The private key stays on the machine. `SOLANA_RPC_URL` can point to an RPC used to simulate transactions; without it, the server uses public Solana mainnet. The MCP process must be running when an order fires. If it is offline, execution waits until it returns and then uses the price at that time.

Before signing, the server simulates each transaction and checks its effects. Set `paper: true` on an order or plan to rehearse it using live route pricing; the transaction is neither signed nor traded.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ONESTOP_PRIVATE_KEY`, `ONESTOP_KEYPAIR_PATH`, `SOLANA_RPC_URL`, `ONESTOP_DRY_RUN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ONESTOP_PRIVATE_KEY=<ONESTOP_PRIVATE_KEY> --env ONESTOP_KEYPAIR_PATH=<ONESTOP_KEYPAIR_PATH> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env ONESTOP_DRY_RUN=<ONESTOP_DRY_RUN> --transport stdio onestop -- npx -y @onestop-trade/onestop-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add onestop --env ONESTOP_PRIVATE_KEY=<ONESTOP_PRIVATE_KEY> --env ONESTOP_KEYPAIR_PATH=<ONESTOP_KEYPAIR_PATH> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env ONESTOP_DRY_RUN=<ONESTOP_DRY_RUN> -- npx -y @onestop-trade/onestop-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "onestop": {
            "command": "npx",
            "args": [
                "-y",
                "@onestop-trade/onestop-mcp"
            ],
            "env": {
                "ONESTOP_PRIVATE_KEY": "<ONESTOP_PRIVATE_KEY>",
                "ONESTOP_KEYPAIR_PATH": "<ONESTOP_KEYPAIR_PATH>",
                "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
                "ONESTOP_DRY_RUN": "<ONESTOP_DRY_RUN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "onestop": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@onestop-trade/onestop-mcp"
            ],
            "env": {
                "ONESTOP_PRIVATE_KEY": "<ONESTOP_PRIVATE_KEY>",
                "ONESTOP_KEYPAIR_PATH": "<ONESTOP_KEYPAIR_PATH>",
                "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
                "ONESTOP_DRY_RUN": "<ONESTOP_DRY_RUN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ONESTOP_PRIVATE_KEY=<ONESTOP_PRIVATE_KEY> -e ONESTOP_KEYPAIR_PATH=<ONESTOP_KEYPAIR_PATH> -e SOLANA_RPC_URL=<SOLANA_RPC_URL> -e ONESTOP_DRY_RUN=<ONESTOP_DRY_RUN> onestop npx -y @onestop-trade/onestop-mcp
```
Replace <…> with your own values

## When to use it
- quote and swap a Solana token
- place a limit, trailing, or TWAP order
- create an entry purchase with a planned exit
- check wallet balances and trade activity

## Example prompts
- Swap this Solana token and show me the quote before submitting.
- Place a limit order to buy this token.
- Create a plan that buys the token and sets a protective exit.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
