bags-sdk-mcp
Allows connecting Coinbase Wallet to sign transactions for token launches, swaps, and fee claims.
Provides image generation capabilities for creating token artwork in scout mode.
Provides tools for interacting with the Solana blockchain, including sending transactions, checking wallet balances, and querying token holdings.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bags-sdk-mcpWhat's trending on Bags?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Install (one command)
npx bags-sdk-mcp --setupGet your API key at dev.bags.fm. The wizard detects your MCP clients, asks for your key, and writes the config. Restart your client and you're live.
claude mcp add bags-sdk-mcp -e BAGS_API_KEY=your-key -- npx bags-sdk-mcpAdd this to your MCP config file:
{
"mcpServers": {
"bags-sdk-mcp": {
"command": "npx",
"args": ["bags-sdk-mcp"],
"env": {
"BAGS_API_KEY": "your-key-here"
}
}
}
}Client | Config path |
Claude Desktop (macOS) |
|
Claude Desktop (Windows) |
|
Cursor |
|
Claude Code |
|
Restart your client after saving.
git clone https://github.com/outerheaven199X/Bags-SDK-hackathon.git
cd Bags-SDK-hackathon
cp .env.example .env # add your BAGS_API_KEY
npm install && npm run build
npm startRelated MCP server: Solana MCP Server
What Is This
bags-sdk-mcp is an MCP server that exposes the entire Bags.fm API as 46 tools, 4 resources, and 8 prompts. Any MCP-compatible AI client — Claude Desktop, Claude Code, Cursor, or custom agents — can interact with the Bags.fm ecosystem through natural language.
No private keys pass through this server. Every tool returns unsigned transaction data. The signing page runs on localhost and connects directly to your browser wallet.
Launch a Coin
You: "Launch a coin called bori, symbol BOOL, 0.001 SOL initial buy"
Agent: shows summary, asks for confirmation
You: "Go"
Agent: opens signing page → connect wallet → sign twice → liveConnect Phantom, Solflare, Backpack, or Coinbase, approve two transactions, and your coin is on-chain.
What Else Can It Do
Say this | Get this |
"What's trending on Bags?" | Recent launches + top tokens |
"Check my wallet" | Balance, holdings, claimable fees |
"Claim all my fees" | Finds and claims every open position |
"Set up a 50/50 fee split" | Fee config built and signed |
"List on Dexscreener" | Profile boost order placed |
"Show pool data for $TOKEN" | Reserves, config, migration status |
"Scan for trending token ideas" | Scout mode + AI-generated launch packages |
46 Tools
Domain | Tools |
Trading |
|
Launch |
|
Fees |
|
Claiming |
|
Partner |
|
Dexscreener |
|
Agent Auth |
|
State |
|
Analytics |
|
Solana |
|
Signing |
|
Scout |
|
Meta |
|
All prefixed with bags_.
Agent Mode
bags-sdk-mcp --agent --auto-claim # claim fees every 5 min
bags-sdk-mcp --agent --monitor # watch launches, flag interesting ones
bags-sdk-mcp --agent --scout # scan trends, propose token launches
bags-sdk-mcp --agent --scout --auto-claim --monitor # all strategiesRequires NOUS_API_KEY and ANTHROPIC_API_KEY.
CLI Reference
SETUP
bags-sdk-mcp --setup Interactive installer for Claude Desktop, Cursor, etc.
bags-sdk-mcp --uninstall Remove from all detected MCP client configs
SERVER
bags-sdk-mcp Start stdio server (default, for MCP clients)
bags-sdk-mcp --http Start HTTP server on port 3000
bags-sdk-mcp --http --port=8080 HTTP on custom port
AGENT
bags-sdk-mcp --agent --auto-claim Claim fees above threshold every 5 min
bags-sdk-mcp --agent --monitor Watch launches, flag interesting ones
bags-sdk-mcp --agent --scout Scan trends, propose token launches
TOOLS
bags-sdk-mcp --fee-optimize Analyze fee configs, suggest improvements
bags-sdk-mcp --rebalance Analyze positions, recommend claim strategy
DIAGNOSTICS
bags-sdk-mcp --doctor Check everything: env, API, RPC, configs, ports
bags-sdk-mcp --info Show current config and capabilities (no network)
bags-sdk-mcp --whoami Test API key and show wallet stats
bags-sdk-mcp --test-key Validate API key only
bags-sdk-mcp --version, -v Print version
bags-sdk-mcp --clear-sessions Wipe expired signing sessionsTroubleshooting
Something isn't working
npx bags-sdk-mcp --doctorDoctor checks your env vars, API key, RPC connectivity, MCP client configs, signing port, and sessions. It tells you exactly what's wrong and how to fix it.
Quick checks
npx bags-sdk-mcp --test-key # is my API key valid?
npx bags-sdk-mcp --info # what does my config look like?
npx bags-sdk-mcp --whoami # what does the server see?Common issues
Problem | Fix |
| Run |
Key validation fails | Get a new key at dev.bags.fm, then |
Signing page won't load | Port 3141 may be in use — |
Stale signing sessions | Run |
Agent mode crashes | Check |
Environment Variables
Variable | Required | Default |
| Yes | — |
| No |
|
| No |
|
| Agent mode | — |
| Agent mode | — |
| Agent mode | — |
| Scout mode |
|
| Scout mode | — |
| Scout mode | — |
| Scout mode |
|
| Scout mode |
|
| Scout mode |
|
Loaded from .env automatically.
Known Issues
npm audit vulnerabilities
Running npm audit reports vulnerabilities in transitive dependencies from @meteora-ag/cp-amm-sdk (Meteora's AMM SDK), which incorrectly ships test frameworks (mocha, chai) as production dependencies. These packages are never imported or executed by bags-sdk-mcp. We've reported this upstream.
Development
npm run build # compile
npm run dev # watch mode
npm run inspect # MCP Inspector
npm test # testsThis server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/outerheaven199X/Bags-SDK-hackathon'
If you have feedback or need assistance with the MCP directory API, please join our Discord server