Bags MCP Server

Use Claude AI to launch tokens, manage fees, and trade on Bags.fm - all through natural conversation.

Quick Start

# Install globally
npm install -g mcp-server-bags

# Run setup wizard
mcp-server-bags --setup

The setup wizard will:

1. Ask for your Bags API key (from dev.bags.fm)
2. Ask for your Solana private key (base58 encoded)
3. Automatically configure Claude Code

Then restart Claude Code and ask: "What Bags tools do you have?"

What You Can Do

| Category | Tools | Description | |----------|-------|-------------| | Token Launch | 6 | Create tokens, set up fee sharing, launch on Solana | | Fee Management | 4 | Claim fees, resolve social accounts to wallets | | Partner | 3 | Earn 25% platform fees as a partner | | Trading | 2 | Get quotes and swap tokens | | Analytics | 1 | View claim history |

16 tools total - see them all with mcp-server-bags --tools

Commands

mcp-server-bags --setup     # Interactive setup wizard
mcp-server-bags --tools     # List all available tools
mcp-server-bags --help      # Show help
mcp-server-bags --version   # Show version

Example Conversations

Launch a token:

"Create a token called 'My Token' with symbol 'MTK' and this image: https://..."

Check partner fees:

"What are my unclaimed partner fees?"

Trade tokens:

"Swap 1 SOL for token ABC"

Set up fee sharing:

"Create a fee share config with 50% to @alice on Twitter and 50% to me"

Manual Configuration

If you prefer manual setup instead of the wizard:

For Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "bags": {
      "command": "mcp-server-bags",
      "env": {
        "BAGS_API_KEY": "your_key",
        "SOLANA_PRIVATE_KEY": "your_base58_key",
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com"
      }
    }
  }
}

For Claude Desktop

Add to claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Same JSON format as above.

Requirements

• Node.js 18+
• Bags API key from dev.bags.fm
• Solana wallet with private key (base58 encoded)

Important Notes

• Transactions are not auto-signed - Claude generates transactions, you sign and broadcast them
• Rate limit: 1,000 requests/hour
• Partner keys: One per wallet, earns 25% platform fees
• Fee claiming: Execute transactions in order (last one withdraws from vault)

Troubleshooting

Setup fails?

• Make sure you have Node.js 18+ installed
• Check your API key is valid at dev.bags.fm

Tools not showing in Claude?

• Restart Claude Code/Desktop after setup
• Run mcp-server-bags --setup again

Transaction errors?

• Ensure wallet has SOL for fees
• Check RPC endpoint is reachable

License

MIT