BagOS

Package (npm 3.0.7)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "bagos": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "BAGS_API_KEY": "<YOUR_VALUE>",
        "BAGS_NETWORK": "<YOUR_VALUE>",
        "SOLANA_RPC_URL": "<YOUR_VALUE>",
        "BAGS_KEYPAIR_PATH": "<YOUR_VALUE>",
        "BAGS_MAX_SOL_PER_TX": "<YOUR_VALUE>",
        "BAGS_MAX_SOL_PER_SESSION": "<YOUR_VALUE>",
        "BAGS_ALLOW_UNCONFIRMED": "<YOUR_VALUE>",
        "BOS_TOKEN_MINT": "<YOUR_VALUE>",
        "BOS_REQUIRED_BALANCE": "<YOUR_VALUE>",
        "BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS": "<YOUR_VALUE>",
        "USE_MOCK_DATA": "<YOUR_VALUE>"
      }
    }
  }
}

• 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.