Package Exports

mcp-server-bags
mcp-server-bags/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mcp-server-bags) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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:

Ask for your Bags API key (from dev.bags.fm)
Ask for your Solana private key (base58 encoded)
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