BagOS
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BAGS_API_KEY | Yes | Your Bags API key from dev.bags.fm. | |
| BAGS_NETWORK | No | Network to use: devnet or mainnet. Writes need mainnet. | devnet |
| BOS_TOKEN_MINT | No | Gating token mint address. Required for writes. | |
| SOLANA_RPC_URL | No | Solana RPC URL. Must agree with BAGS_NETWORK or the server refuses to start. | |
| BAGS_KEYPAIR_PATH | No | Path to your Solana keypair file (JSON byte array). Required for writes. | ~/.config/bags/keypair.json |
| BAGS_MAX_SOL_PER_TX | No | Per-transaction spend cap in SOL. | 0.1 |
| BOS_REQUIRED_BALANCE | No | Minimum gating-token balance. Set to 0 to disable gate. | 10000 |
| BAGS_ALLOW_UNCONFIRMED | No | Set to true to skip the confirmation step. | false |
| BAGS_MAX_SOL_PER_SESSION | No | Per-process spend cap in SOL. | 1.0 |
| BAGS_ALLOW_UNCAPPED_TOKEN_SWAPS | No | Set to true to permit swaps whose input is not SOL (uncapped). | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| bags_authenticateA | Authenticate with Bags API utilizing the V2 signature challenge flow. Automatically loads local wallet. |
| bags_claim_feesA | GATED WRITE: Claim pending creator/LP fees for the given token mints. Requires $BOS. Two-step: the first call previews and returns a confirmation token; call again with it to sign and submit. Returns confirmed on-chain signatures. |
| bags_execute_tradeA | GATED WRITE: Swap tokens on Bags pools. Requires $BOS. Two-step: the first call returns a preview and a confirmation token; call again with that token to sign and submit. Returns a confirmed on-chain signature. SOL mint: So11111111111111111111111111111111111111112. |
| bags_get_claimable_feesA | Query all claimable creator/LP fees for a wallet. Free read-only tier. |
| bags_get_creatorsB | Query top creators by lifetime fees on Bags. Free read-only tier. |
| bags_get_partner_statsA | View partner referral earnings for the configured wallet. Free read-only tier. |
| bags_get_token_analyticsA | Get pool info, claim stats, and bonding curve progress for a token. Free read-only tier. |
| bags_get_token_claim_eventsA | Get the fee-claim audit trail for a token: who claimed, how much, when, and the transaction signature. Paginated via limit/offset. Free read-only tier. |
| bags_get_token_claim_statsA | Get per-creator claim totals for a token: each fee-share creator with their royalty split and total claimed amount. Free read-only tier. |
| bags_get_token_creatorsA | Get the royalty split for a token: every creator sharing its fees, their wallet, social provider, and share in basis points. Free read-only tier. |
| bags_get_trade_quoteA | Get a swap quote to trade SOL and any Bags ecosystem token. Free read-only tier. SOL mint: So11111111111111111111111111111111111111112. Default BOS token mint: EkJuyYyD3to61CHVPJn6wHb7xANxvqApnVJ4o2SdBAGS. |
| bags_heartbeatA | Periodic health check combining basic node status with an earnings/balance summary. Free read-only tier. |
| bags_prepare_token_metadataA | GATED: Create token info and metadata on Bags, returning the reserved mint address and metadata URL. Requires $BOS. This PREPARES a launch — it does not launch the token and does not send an on-chain transaction. |
| bags_resolve_launch_walletA | Resolve a social handle (twitter, tiktok, kick, or github) to its Bags fee-share launch wallet. Free read-only tier. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Each tool targets a distinct operation or resource, and the write vs read-only distinction is clear from descriptions. Minor overlap remains between get_token_analytics and get_token_claim_stats (both expose claim stats) and between get_creators and get_token_creators.
All tools share the bags_ prefix and mostly follow a verb_object pattern (get_, execute_, claim_, prepare_). Minor deviations include bags_heartbeat, which is a noun, and bags_authenticate, which is a bare verb.
14 tools is well within the ideal range and covers authentication, trading, fee claiming, analytics, and token metadata preparation without feeling bloated. Each tool serves a clear purpose in the overall workflow.
The surface covers the main read-only analytics, trade quoting/execution, fee claims, and metadata preparation workflows. The most notable gap is that a prepared token launch cannot be executed through the server, but the core trade and fee lifecycle is otherwise well covered.