Gainium
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GAINIUM_API_KEY | Yes | Your Gainium API public key (app.gainium.io → Settings → API) | |
| GAINIUM_READONLY | No | Set to 'true' to expose only read-only tools | |
| GAINIUM_API_SECRET | Yes | Your Gainium API secret (paired with GAINIUM_API_KEY) | |
| GAINIUM_PAPER_ONLY | No | Set to 'true' to restrict to paper-trading bots | false |
| GAINIUM_API_BASE_URL | No | Override API base URL | https://api.gainium.io |
| GAINIUM_ALLOWED_BOT_ID | No | Optional: restrict all operations to a single bot ID |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_botsA | List bots by type (DCA, Combo, or Grid). Supports field selection presets (minimal, standard, extended, full). Supports filtering by status and paper/real trading context. |
| get_botA | Get a single bot by its MongoDB ObjectId or UUID. Supports the same field selection presets as list_bots. |
| create_botA | Create a new bot in a single step — no follow-up update needed. The top-level properties cover the most common fields. For any field from discover(target: "bot") that is NOT listed here (e.g. startOrderType, useMoveTP, moveTPTrigger, moveTPValue, stopLossTimeout, takeProfitTimeout, dcaOrdersMultiplier, dcaStepMultiplier, trailingTP, trailingTPPerc, indicators, timers, and any other discovery field), pass them inside the 'settings' object — it is transparently merged into the request body at creation time. This avoids a create→update two-step. Use discover(target: 'bot', botType) to discover all available fields and defaults. The 'futures' and 'coinm' fields are auto-detected from the exchange — do not provide them. Requires write API key permission. |
| update_botA | Update an existing bot (DCA or Combo only; Grid has no update endpoint). Pass only the fields you want to change. Settings object must be non-empty. Boolean gate enforcement: feature value fields are silently ignored unless their toggle is set to true. |
| clone_botA | Clone an existing bot and optionally override settings. Returns the new bot ID. |
| manage_botA | Manage bot lifecycle: start, stop, archive, restore, or change trading pairs (DCA only). Each action has specific requirements. |
| list_dealsA | List deals by type (DCA, Combo, or Terminal). Supports field selection presets. Supports filtering by status and botId. |
| get_dealA | Get a single deal by its MongoDB ObjectId. Supports the same field selection presets as list_deals. |
| create_dealA | Create a new deal. For dca/combo: starts a deal from an existing bot. For terminal: creates a standalone terminal deal. |
| update_dealA | Update an existing deal. Pass only the fields you want to change. Settings object must be non-empty. |
| manage_dealB | Manage deal operations: close a deal, add funds, or reduce funds. Each action has specific requirements. |
| run_backtestA | Run a backtest operation: validate, estimate cost, request async, or request with sync response. Pass a backtest payload with exchange, exchangeUUID, and bot settings. |
| backtest_infoA | Get backtest information: list requests, fetch a specific request, get operation schema, or build a payload template. |
| discoverA | Discover bots, bot details, bot sections, indicators, or supported exchanges. Use this to learn available fields, defaults, and strategies. |
| get_accountB | Get account information: balances, connected exchanges, global variables, or supported exchanges. |
| manage_global_variableA | Create, update, or delete a global variable. Variables are user-defined constants accessible in strategies. |
| get_screenerC | Get cryptocurrency screener results. Filter by market cap, volume, and sort by various metrics. |
| list_presetsA | List curated bot-strategy presets, ranked by backtested performance. Each coin returns tiers (short/mid/long) × strategy (long/short) with ROI, drawdown, and the full strategy settings for review and comparison. |
| apply_presetA | Create a bot from a curated preset in one call: fetches the preset for the given coin/exchange/tier/strategy, then creates a bot from its settings. Override pair, name, or sizing as needed. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Gainium agent workflow | Canonical layer model, recommended flows, and terminology reference for using the Gainium MCP tools. Read this to understand how discovery, bot creation, and backtest tools relate to each other. |
Latest Blog Posts
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/Gainium/gainium-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server