BagOS MCP Server

Name: BagOS MCP Server
Author: io.github.edycutjong

io.github.edycutjong/bagos

Repository Registry

What is the BagOS MCP server?

MCP server for Bags on Solana: token analytics, trade quotes, and gated write operations.

How to install BagOS

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

BAGS_API_KEY
required
secret
Bags API key from dev.bags.fm. Required for all tools.
BAGS_NETWORK
Solana cluster: devnet (default) or mainnet. Writes on mainnet move real funds.
SOLANA_RPC_URL
secret
Custom Solana RPC endpoint. Defaults to the public RPC for BAGS_NETWORK.
BAGS_KEYPAIR_PATH
Path to a Solana keypair JSON file. Only required for write tools.
BAGS_MAX_SOL_PER_TX
Hard cap on SOL spent by any single transaction. Default 0.1.
BAGS_MAX_SOL_PER_SESSION
Hard cap on total SOL spent across one server session. Default 1.0.
BAGS_ALLOW_UNCONFIRMED
Set true to skip the two-step confirmation on writes. Default false.
BOS_TOKEN_MINT
Mint address of the BOS token used for gating write tools.
BOS_REQUIRED_BALANCE
Minimum BOS balance required to call write tools. Default 10000.
BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS
Permit non-SOL-input swaps, which the SOL-denominated caps cannot limit.
USE_MOCK_DATA
Makes bags_get_claimable_fees return fabricated data instead of calling the API. Default false.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bagos": {
      "command": "npx",
      "args": [
        "-y",
        "bagos-mcp-server"
      ],
      "env": {
        "BAGS_API_KEY": "<YOUR_BAGS_API_KEY>",
        "BAGS_NETWORK": "<YOUR_BAGS_NETWORK>",
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "BAGS_KEYPAIR_PATH": "<YOUR_BAGS_KEYPAIR_PATH>",
        "BAGS_MAX_SOL_PER_TX": "<YOUR_BAGS_MAX_SOL_PER_TX>",
        "BAGS_MAX_SOL_PER_SESSION": "<YOUR_BAGS_MAX_SOL_PER_SESSION>",
        "BAGS_ALLOW_UNCONFIRMED": "<YOUR_BAGS_ALLOW_UNCONFIRMED>",
        "BOS_TOKEN_MINT": "<YOUR_BOS_TOKEN_MINT>",
        "BOS_REQUIRED_BALANCE": "<YOUR_BOS_REQUIRED_BALANCE>",
        "BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS": "<YOUR_BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS>",
        "USE_MOCK_DATA": "<YOUR_USE_MOCK_DATA>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "bagos": {
      "command": "npx",
      "args": [
        "-y",
        "bagos-mcp-server"
      ],
      "env": {
        "BAGS_API_KEY": "<YOUR_BAGS_API_KEY>",
        "BAGS_NETWORK": "<YOUR_BAGS_NETWORK>",
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "BAGS_KEYPAIR_PATH": "<YOUR_BAGS_KEYPAIR_PATH>",
        "BAGS_MAX_SOL_PER_TX": "<YOUR_BAGS_MAX_SOL_PER_TX>",
        "BAGS_MAX_SOL_PER_SESSION": "<YOUR_BAGS_MAX_SOL_PER_SESSION>",
        "BAGS_ALLOW_UNCONFIRMED": "<YOUR_BAGS_ALLOW_UNCONFIRMED>",
        "BOS_TOKEN_MINT": "<YOUR_BOS_TOKEN_MINT>",
        "BOS_REQUIRED_BALANCE": "<YOUR_BOS_REQUIRED_BALANCE>",
        "BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS": "<YOUR_BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS>",
        "USE_MOCK_DATA": "<YOUR_USE_MOCK_DATA>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "bagos": {
      "command": "npx",
      "args": [
        "-y",
        "bagos-mcp-server"
      ],
      "env": {
        "BAGS_API_KEY": "<YOUR_BAGS_API_KEY>",
        "BAGS_NETWORK": "<YOUR_BAGS_NETWORK>",
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "BAGS_KEYPAIR_PATH": "<YOUR_BAGS_KEYPAIR_PATH>",
        "BAGS_MAX_SOL_PER_TX": "<YOUR_BAGS_MAX_SOL_PER_TX>",
        "BAGS_MAX_SOL_PER_SESSION": "<YOUR_BAGS_MAX_SOL_PER_SESSION>",
        "BAGS_ALLOW_UNCONFIRMED": "<YOUR_BAGS_ALLOW_UNCONFIRMED>",
        "BOS_TOKEN_MINT": "<YOUR_BOS_TOKEN_MINT>",
        "BOS_REQUIRED_BALANCE": "<YOUR_BOS_REQUIRED_BALANCE>",
        "BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS": "<YOUR_BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS>",
        "USE_MOCK_DATA": "<YOUR_USE_MOCK_DATA>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "bagos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bagos-mcp-server"
      ],
      "env": {
        "BAGS_API_KEY": "<YOUR_BAGS_API_KEY>",
        "BAGS_NETWORK": "<YOUR_BAGS_NETWORK>",
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "BAGS_KEYPAIR_PATH": "<YOUR_BAGS_KEYPAIR_PATH>",
        "BAGS_MAX_SOL_PER_TX": "<YOUR_BAGS_MAX_SOL_PER_TX>",
        "BAGS_MAX_SOL_PER_SESSION": "<YOUR_BAGS_MAX_SOL_PER_SESSION>",
        "BAGS_ALLOW_UNCONFIRMED": "<YOUR_BAGS_ALLOW_UNCONFIRMED>",
        "BOS_TOKEN_MINT": "<YOUR_BOS_TOKEN_MINT>",
        "BOS_REQUIRED_BALANCE": "<YOUR_BOS_REQUIRED_BALANCE>",
        "BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS": "<YOUR_BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS>",
        "USE_MOCK_DATA": "<YOUR_USE_MOCK_DATA>"
      }
    }
  }
}

Claude Code

claude mcp add bagos --env BAGS_API_KEY=<YOUR_BAGS_API_KEY> --env BAGS_NETWORK=<YOUR_BAGS_NETWORK> --env SOLANA_RPC_URL=<YOUR_SOLANA_RPC_URL> --env BAGS_KEYPAIR_PATH=<YOUR_BAGS_KEYPAIR_PATH> --env BAGS_MAX_SOL_PER_TX=<YOUR_BAGS_MAX_SOL_PER_TX> --env BAGS_MAX_SOL_PER_SESSION=<YOUR_BAGS_MAX_SOL_PER_SESSION> --env BAGS_ALLOW_UNCONFIRMED=<YOUR_BAGS_ALLOW_UNCONFIRMED> --env BOS_TOKEN_MINT=<YOUR_BOS_TOKEN_MINT> --env BOS_REQUIRED_BALANCE=<YOUR_BOS_REQUIRED_BALANCE> --env BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS=<YOUR_BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS> --env USE_MOCK_DATA=<YOUR_USE_MOCK_DATA> -- npx -y bagos-mcp-server