BAGSX MCP Server v2.0

🤖 "Hey Claude, swap 1 SOL for BAGSX"

The first MCP server that lets Claude trade Solana tokens for you

🚀 Quick Start • 💰 Buy $BAGSX • 📖 Docs • 🎥 Demo

🎥 Demo

Coming soon: GIF showing live Claude + BAGSX interaction

You: "What can I claim for wallet 7xK2..."
Claude: You have 0.57 SOL claimable across 2 tokens. Want me to generate the claim transactions?
You: "Yes"
Claude: Done. Copy this unsigned transaction to Phantom and sign it.

Zero custody. You always hold your keys.

💎 $BAGSX Token

| 🪙 Token | 📍 Mint Address | 🛒 Buy Now | |----------|-----------------|------------| | $BAGSX | BA6ggscnXVgfENwPGk9CXeEqKR67T9z6n64G5ue5BAGS | bags.fm/BAGSX |

Every trade on $BAGSX generates creator fees → Reinvested into development + hackathon prizes.

🔥 Why BAGSX?

| Before BAGSX | With BAGSX | |--------------|------------| | ❌ Copy-paste addresses into DEX | ✅ "Claude, swap 1 SOL for BAGSX" | | ❌ Manually check fee claims | ✅ "What can I claim across all tokens?" | | ❌ Complex token launch process | ✅ "Launch a token called DEMO" | | ❌ Manage fee splits in code | ✅ "Split fees 50/50 with this wallet" |

This is what DeFi should feel like. Talk to your AI, get things done.

✨ Features

BAGSX is a Model Context Protocol (MCP) server that connects Claude to the Bags.fm API — enabling AI-powered trading, token launches, and fee management on Solana.

Talk to Claude in plain English to:

💰 Get swap quotes and execute trades with slippage protection
🚀 Launch tokens with automatic metadata and bonding curves
💸 Claim creator fees from your launched tokens
📊 View analytics on creators, fees, and claim events
⚙️ Configure fee sharing with multiple wallets

Built for the $4M Bags Hackathon — 19 real API tools

Features

| Feature | Description | |---------|-------------| | 🛠️ 19 Real Tools | Every tool maps to an actual Bags API endpoint — no fake data | | 💱 Trading | Get quotes, execute swaps with auto-slippage protection | | 🚀 Token Launch | Prepare metadata + create bonding curve tokens in 2 commands | | 💸 Fee Management | Claim fees, configure splits, transfer admin — all via chat | | 🔐 Zero Custody | All transactions are UNSIGNED — you sign in your wallet | | ⚡ Fast | Direct API calls, no on-chain simulation overhead |

Security Model

BAGSX uses unsigned transactions — your private keys NEVER leave your wallet:

You ask Claude to trade/claim/etc
BAGSX generates an unsigned transaction
You copy the transaction to your wallet (Phantom/Solflare)
You sign and submit yourself

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Claude + MCP  │ → │  Unsigned TX    │ → │  Your Wallet    │
│   (analysis)    │    │  (base64 blob)  │    │  (you sign)     │
└─────────────────┘    └─────────────────┘    └─────────────────┘

Zero custody risk. We never see your private key.

Installation

Prerequisites

Node.js 18+
Bags API Key (free)
Claude Desktop or any MCP client
A Solana wallet (Phantom, Solflare, Backpack)

Quick Install

# Clone the repo
git clone https://github.com/chunk97-bot/bagsx-mcp.git
cd bagsx-mcp

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your Bags API key

# Build
npm run build

Add to Claude Desktop

Edit your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac or %APPDATA%/Claude/claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "bagsx": {
      "command": "node",
      "args": ["/path/to/bagsx-mcp/dist/index.js"],
      "env": {
        "BAGS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. You'll see "bagsx" in the MCP servers list.

Usage

Once connected, just talk to Claude:

Get Swap Quotes

"Get a quote for swapping 0.5 SOL to BAGSX"
"What's the price to swap 1 SOL to this token?"
"Quote me a swap from SOL to BA6ggscnXVgfENwPGk9CXeEqKR67T9z6n64G5ue5BAGS"

Execute Trades

"Execute that swap with my wallet 7xK2..."
"Create a swap transaction for wallet ABC123..."

Launch Tokens

"Prepare a token called DEMO with symbol DMO"
"Create token metadata with description 'My awesome project'"

Claim Creator Fees

"What fees can I claim for wallet 7xK2...?"
"Show my claimable positions"
"Generate claim transactions for this token"

Manage Fee Sharing

"Look up fee wallet for Twitter user @username"
"Create fee share config splitting 50/50 between two wallets"
"List tokens where I'm admin"

View Analytics

"Show creators for token XYZ"
"What are the lifetime fees for BAGSX?"
"Get claim stats for this token mint"

Tools

💰 Trading (2 Tools)

| Tool | Description | |------|-------------| | bags_quote | Get swap quotes with price impact & slippage. Supports auto or manual slippage. | | bags_swap | Create unsigned swap transaction from a quote. You sign in your wallet. |

🚀 Token Launch (2 Tools)

| Tool | Description | |------|-------------| | bags_launch_prepare | Create token metadata (name, symbol, image, socials). Returns mint address. | | bags_launch_execute | Create bonding curve launch transaction. You sign to deploy. |

📊 Analytics (4 Tools)

| Tool | Description | |------|-------------| | bags_creators | Get creator info and royalty settings for a token. | | bags_lifetime_fees | Total fees generated by a token since launch. | | bags_claim_stats | Who claimed fees and how much (per wallet breakdown). | | bags_claim_events | Historical claim events with timestamps & signatures. |

💸 Fee Claiming (2 Tools)

| Tool | Description | |------|-------------| | bags_claimable | Check claimable positions for a wallet (all tokens). | | bags_claim_fees | Generate unsigned transactions to claim fees. You sign. |

⚙️ Fee Share Config (5 Tools)

| Tool | Description | |------|-------------| | bags_fee_wallet | Look up fee share wallet for a social username (Twitter, etc). | | bags_fee_config | Create fee share configuration with multiple claimers & splits. | | bags_admin_list | List tokens where a wallet has admin rights. | | bags_admin_update | Update fee share splits (admin only). | | bags_admin_transfer | Transfer admin rights to another wallet. |

🏊 State/Pools (2 Tools)

| Tool | Description | |------|-------------| | bags_pools | List all Bags pools (optionally filter to migrated only). | | bags_pool_info | Get pool details by token mint address. |

🤝 Partner (2 Tools)

| Tool | Description | |------|-------------| | bags_partner_stats | View claimed and unclaimed partner fees. | | bags_partner_claim | Generate unsigned transactions to claim partner fees. |

Usage Examples

Getting a Swap Quote

You: "Get a quote for swapping 0.5 SOL to the BAGSX token"

Claude: [Uses bags_quote tool]

Quote details:
- Input: 0.5 SOL (500000000 lamports)
- Output: ~2,547,510,849,175,944 BAGSX
- Price Impact: 0.002%
- Slippage: 100 bps (1%)
- Request ID: 64aa5700-1f3b-4127-a191-5311ab0274aa

Use bags_swap with this request ID to execute the trade.

Executing a Swap

You: "Execute that swap with my wallet 7xK2..."

Claude: [Uses bags_swap tool]

Unsigned transaction ready:
- Transaction: AQAAAA...
- Block Height: 234567890
- Priority Fee: 5000 lamports

To complete: Copy to Phantom → Sign → Submit

Launching a Token

You: "Prepare a token called DEMO with symbol DMO"

Claude: [Uses bags_launch_prepare tool]

Token info created:
- Mint: 9xYz123...
- Metadata URI: ipfs://...
- Status: Ready

Use bags_launch_execute to deploy the bonding curve.

Claiming Creator Fees

You: "What fees can I claim for wallet 7xK2...?"

Claude: [Uses bags_claimable tool]

Claimable positions:
| Token | Amount |
|-------|--------|
| BAGSX | 0.42 SOL |
| DEMO  | 0.15 SOL |

Total: 0.57 SOL

Shall I generate claim transactions?

Configuration

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | BAGS_API_KEY | Yes | Your Bags API key from dev.bags.fm |

Get Your API Key

Go to dev.bags.fm
Sign up / log in
Create a new API key
Add to your .env file

Development

# Run in development mode
npm run dev

# Build for production
npm run build

# Start production server
npm start

Project Structure

bagsx-mcp/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── config.ts             # Configuration management
│   ├── lib/
│   │   └── bags-client-new.ts # Bags API client (19 methods)
│   └── tools/
│       ├── definitions-new.ts # Tool schemas (19 tools)
│       └── handlers-new.ts    # Tool implementations
├── package.json
├── tsconfig.json
└── README.md

Security

🔒 Private keys never needed — All transactions are unsigned
🔒 API key in environment — Not hardcoded or exposed to Claude
🔒 You sign everything — Full control over what gets submitted
🔒 Open source — Audit the code yourself

Roadmap

[x] Core MCP server with real API integration
[x] 19 working tools (trading, launch, fees, analytics)
[x] Zero custody security model
[x] $BAGSX token launch
[ ] Additional analytics as Bags API expands
[ ] Real-time price feeds (when available)

License

MIT License — see LICENSE

Built for the $4M Bags Hackathon 2026

Apply Now • Discord • Twitter