Bags.fm

README

🤖 "Hey Claude, swap 1 SOL for BAGSX"

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

npm version License: MIT MCP Compatible Bags Hackathon 19 Tools $BAGSX Token

🚀 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

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

🔥 Why BAGSX?

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

Security Model

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

1. You ask Claude to trade/claim/etc
2. BAGSX generates an unsigned transaction
3. You copy the transaction to your wallet (Phantom/Solflare)
4. 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/Maaz-1997/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)

🚀 Token Launch (2 Tools)

📊 Analytics (4 Tools)

💸 Fee Claiming (2 Tools)

⚙️ Fee Share Config (5 Tools)

🏊 State/Pools (2 Tools)

🤝 Partner (2 Tools)

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

Get Your API Key

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

Categories

This project is submitted to the Bags Hackathon 2026 under:

• ✅ Claude Skills — MCP server for Claude integration
• ✅ Bags API — Full integration with public Bags.fm API
• ✅ AI Agents — Enables AI-powered trading via natural language

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

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

Links

• Bags.fm: https://bags.fm
• Bags API Docs: https://docs.bags.fm
• Bags Hackathon: https://bags.fm/hackathon
• MCP Specification: https://modelcontextprotocol.io

License

MIT License — see LICENSE