BagOS MCP Server

by edycutjongio.github.edycutjong/bagosv3.0.7

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

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active13d ago

Install BagOS MCP server

claude mcp add bagos -e BAGS_API_KEY='<bags-api-key>' -e SOLANA_RPC_URL='<solana-rpc-url>' -- npx -y bagos-mcp-server

{
  "mcpServers": {
    "bagos": {
      "command": "npx",
      "args": [
        "-y",
        "bagos-mcp-server"
      ],
      "env": {
        "BAGS_API_KEY": "<bags-api-key>",
        "SOLANA_RPC_URL": "<solana-rpc-url>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "bagos": {
      "command": "npx",
      "args": [
        "-y",
        "bagos-mcp-server"
      ],
      "env": {
        "BAGS_API_KEY": "<bags-api-key>",
        "SOLANA_RPC_URL": "<solana-rpc-url>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "bagos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bagos-mcp-server"
      ],
      "env": {
        "BAGS_API_KEY": "<bags-api-key>",
        "SOLANA_RPC_URL": "<solana-rpc-url>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "bagos": {
      "command": "npx",
      "args": [
        "-y",
        "bagos-mcp-server"
      ],
      "env": {
        "BAGS_API_KEY": "<bags-api-key>",
        "SOLANA_RPC_URL": "<solana-rpc-url>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
BAGS_API_KEY	yes	yes	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	—	yes	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.

Freshness

Active — last maintenance signal 13d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-26 · 13d ago · GitHub
Latest release
2026-09-26 · 13d ago · GitHub · v3.0.7
Package published
no data · npm/PyPI
Registry entry updated
2026-09-26 · 13d ago · official registry · v3.0.7

FAQ

›How do I install the BagOS MCP server in Claude Code?

Run: claude mcp add bagos -e BAGS_API_KEY='<bags-api-key>' -e SOLANA_RPC_URL='<solana-rpc-url>' -- npx -y bagos-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does BagOS require an API key?

Yes. It expects BAGS_API_KEY, SOLANA_RPC_URL, of which 2 are secrets.

›Can I use BagOS as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is BagOS in the official MCP registry?

Yes, as io.github.edycutjong/bagos.