{"name":"maker-mcp","version":"0.4.2","title":"Maker — Solana market-making for agents","protocolVersion":"2024-11-05","auth_required":false,"auth_note":"Org-scoped tools require api_key (mk_live_…) in tool arguments or Authorization header forwarded to REST.","overview":{"product":"Maker","summary":"Multi-chain market-making for agents (Solana + Robinhood Chain 4663). API/MCP free (x402 off). Prefer BYO external wallets (register address + client sign). Optional custodial workers. Chain-specific: Solana uses Jupiter+Jito; Robinhood uses Uniswap+ETH gas (no Jito).","chains":{"solana":{"always_on":true,"swap":"jupiter","inclusion":"jito_tip + helius priority","privacy":"privacy_cash_sol","dexscreener":"solana","address":"base58"},"robinhood":{"chainId":4663,"flags":["MAKER_RH_CHAIN_ENABLED","MAKER_RH_WRITE_GO","MAKER_RH_BRIDGE_ENABLED"],"swap":"uniswap","inclusion":"evm_gas (maxFeePerGas / maxPriorityFeePerGas) — NO jito","privacy":"bridge RH→SOL → Privacy Cash → optional SOL→RH","dexscreener":"robinhood","address":"0x evm"}},"workflow":["1. maker_capabilities / maker_chains_list (discover surfaces + chain flags)","2. maker_create_api_key","3. If user pastes a token: maker_token_resolve_chain → maker_token_lookup (chain=solana|robinhood|any)","4a. Solana BYO: maker_external_wallet_register(chain=solana) → maker_trade_build → sign → maker_trade_submit","4b. RH BYO: maker_external_wallet_register(chain=robinhood) → maker_rh_trade_build → sign → maker_rh_trade_submit","4c. Custodial SOL (only if create+fund): funding_session → wallets_batch → funding_allocate (Privacy Cash)","5. maker_warmup_plan(chain=…) before warmup — RH rejects jito_tip; uses Uniswap+ETH gas","6. maker_warmup / strategy_* on Solana workers (RH strategy live path gated by WRITE_GO)","7. Bridge: maker_bridge_lanes → maker_bridge_plan or maker_bridge_private_fund_plan (RH↔SOL; PC SOL-only)","8. maker_job_status / maker_jobs_list / maker_roi"],"rules":["API/MCP/Telegram FREE for now — no deposit required to use the API","PREFER BYO external wallets: address-only register; user signs client-side (no key on our side)","CUSTODIAL optional: we mint workers, store keys encrypted in vault — only when user wants create+fund","Never reuse Solana knobs on Robinhood: no jito_tip_lamports on RH — use max_fee_per_gas_gwei / max_priority_fee_gwei","Token first: resolve chain (shape + DexScreener) before strategy/warmup/MM","Privacy Cash is SOL-only — RH private fund multi-hops via bridge","Deposit/treasury only for custodial funding pool — do not require it for BYO or free API use","Pull custodial funds out with maker_wallet_withdraw — keys stay vaulted; no key export","NEVER send private keys over MCP/API — only mk_live_… and public addresses","Remote HTTPS: https://dayprotocol.com/mm/mcp and https://dayprotocol.com/mm/v1/…","api_key (mk_live_…) IS your account — mint once, pass on every org-scoped tool","Every action is a job — poll maker_job_status for progress/activity","Amounts/times are {min,max,unit?} ranges (pin min=max for fixed)","Warmup: tokens/contracts[] optional; omit → high-volume discovery (chain-scoped)","Buy/sell commands require amount + execution_duration ranges"],"concepts_doc":"docs/OVERVIEW.md","rh_doc":"docs/ROBINHOOD-CHAIN.md","tool_count":64,"tools":[{"name":"maker_capabilities","description":"LIST ALL API CALLS: returns every REST endpoint + MCP tool with instructions, curl, inputs, auth. Also how_to_test (1=create key, 2=list APIs). Call this first. Free."},{"name":"maker_health","description":"Liveness: funding rail mode, x402 on/off, telegram fee, RH flag, swap/market flags, wallet/job counts. Free."},{"name":"maker_feedback","description":"Send product feedback to Maker ops (logged on server). Use when the user is happy, stuck, or frustrated — or when YOU detect frustration (broken, hate this, doesn't work, waste of time). Free. Optional api_key links to their org. message required."},{"name":"maker_stats","description":"Platform aggregates only: API keys minted/active/revoked, orgs, telegram users (active window), wallets (external/custodial/RH), jobs. NEVER returns key secrets or prefixes. Free."},{"name":"maker_fees","description":"How fees work (USDC on Solana + Robinhood) + how to turn them on/off. API/MCP: X402_ENABLED + X402_PRICE_USDC. Telegram @daymmbot: TELEGRAM_MSG_FEE_USDC. Free to read."},{"name":"maker_x402_pricing","description":"x402 payment requirements. Free while X402_ENABLED=false. When on: USDC per successful call on Solana and Robinhood Chain. See maker_fees."},{"name":"maker_list_templates","description":"FULL STRATEGY GUIDE: all templates (PMM, volume_boost/bump/advanced multi-maker, dip/TP, LP scale), venues (Meteora DLMM, Raydium, Orca, Jupiter), risk params, volume knobs (target_makers, volume_buy_ratio_pct, act_delay_seconds, bump_budget_sol). Volume bots rotate wallets for unique makers + randomized delays. ALWAYS call before maker_strategy_create."},{"name":"maker_phoenix_markets","description":"List known Phoenix market registry entries (base/quote mints). Configure via phoenix-markets.json."},{"name":"maker_token_lookup","description":"Look up a token by contract/mint via DexScreener. Solana mint (base58) or EVM 0x (Robinhood). Pass chain=solana|robinhood|any (default any → auto). Returns symbol, price, liquidity, volume, pairs. Prefer maker_token_resolve_chain first if chain unknown."},{"name":"maker_lp_scale_plan","description":"Build a one-sided or two-sided LP scale-in/out ladder plan for a mint. Venues: Meteora DLMM (default), Raydium CLMM, Orca Whirlpools. Returns rungs (offset_bps + weights), risk caps, pool UI hints, and a suggested Maker strategy template (dip_grid_accum / tp_ladder_mm / concentrated_lp_narrow). Use before depositing liquidity to scale in (buy dips) or scale out (sell into strength). Free — api_key optional."},{"name":"maker_token_intel","description":"FULL token forensics for decision-making: market tape (liq, vol m5/h1/h6/h24, txns, price Δ, pair age, trades/day est), top holders (largest token accounts + concentration), active traders sampled from recent pool signatures, and signals (thin liq, dead volume, dumping, holder concentration, etc.). Use before recommending or starting strategies. Free — api_key optional."},{"name":"maker_strategy_campaign","description":"BEST DECISION PATH: full intel (market+holders+traders) → score ALL strategy templates → ranked scorecard → execute_order (phased) + parallel_groups + optional orchestrator plan for #1. Prefer this over maker_strategy_recommend when user asks what to run / campaign / multi-strategy. Returns summary, top picks with why/venues/overrides, phase 1→2→3 order (e.g. volume seed then PMM then scale-out). Free — api_key optional. Still confirm before maker_execute_plan / strategy_start."},{"name":"maker_strategy_recommend","description":"Quick regime recommend (market activity only). For best decisions prefer maker_strategy_campaign (intel + full scorecard + phased execute order). Dead/quiet → volume/grid; liquid → tight_liquid_pmm; dumping → dip_grid_accum. Free — api_key optional."},{"name":"maker_plan","description":"ORCHESTRATOR: turn freeform intent into a multi-step job plan (research / BYO / create+fund / warmup / strategy). Fills product defaults, optional market-activity template pick when mint present. Returns plan_id + confirm_token + steps — does NOT execute. User must confirm (go/yes or confirm_token) then maker_execute_plan. Use when user says what they want done in natural language."},{"name":"maker_execute_plan","description":"ORCHESTRATOR: execute a plan from maker_plan after user confirmation. Requires plan_id + (confirm_token matching the plan OR confirmed=true with confirm_token=go). Runs steps in order (create wallets → fund → warmup → strategy create/start, etc.). Never invent plan_id."},{"name":"maker_create_api_key","description":"Mint long-lived API key = your Maker account. CRITICAL: response.key (mk_live_…) is shown ONCE — save it immediately. Server stores only a one-way hash + short prefix; lose the key → lose access to every custodial wallet under that org (keys stay vaulted but you cannot auth). First call (no key) creates org. Subsequent keys need an existing key for same org. Never returns other users' keys."},{"name":"maker_account","description":"Look up your account from API key: org_id, wallet/job/strategy counts, available_sol + open deposit_addresses. API is free — deposit/available_sol only matters if you use custodial create+fund (not for BYO external wallets)."},{"name":"maker_list_api_keys","description":"List API key METADATA for YOUR org only: id, short prefix (mk_live_xxxx), label, created_at. NEVER returns full secrets or hashes. No global key dump exists."},{"name":"maker_revoke_api_key","description":"Revoke an API key by id."},{"name":"maker_wallets_batch","description":"CREATE custodial worker wallets. Private keys are generated server-side, encrypted in vault, and NEVER returned/exported via API or MCP. Paced: create_per_day default 2-3, spacing 120-300 minutes. ALWAYS pass a human-descriptive name (e.g. 'Create 3 workers · paced 2-3/day') so maker_jobs_list is readable. Returns job id — poll maker_job_status. To get SOL out later use maker_wallet_withdraw (destination address only)."},{"name":"maker_wallets_list","description":"List wallets (id, pubkey, status: created|funded|warming|ready|disabled). Optional status filter."},{"name":"maker_wallet_get","description":"Get one wallet by id (public fields only — no private key)."},{"name":"maker_wallet_withdraw","description":"PULL FUNDS OUT of a custodial worker into the user's own wallet. ONE-SHOT SOL transfer to to_address. Maker keeps operating the worker key in vault — private keys are NEVER exported/downloaded. Required: wallet_id, to_address (user's base58 pubkey), amount {min,max,unit:sol}. Optional WITHDRAW_ALLOWLIST; hard cap WITHDRAW_MAX_SOL (default 50). Returns a withdraw job — poll maker_job_status."},{"name":"maker_external_wallet_register","description":"Register a USER-OWNED wallet by pubkey/address only. NON-CUSTODIAL: Maker NEVER stores the private key. chain=solana (default, base58) or robinhood (0x, requires MAKER_RH_CHAIN_ENABLED). Solana trade: maker_trade_build → sign → submit. RH trade: maker_rh_trade_build → sign → maker_rh_trade_submit. External wallets cannot fund/warmup/strategy/withdraw through custodial paths."},{"name":"maker_trade_build","description":"Build an UNSIGNED swap for a registered external wallet. Returns unsigned_tx_base64 + trade_id. OWNER signs client-side — private key NEVER touches Maker. Submit via maker_trade_submit within ~60s (blockhash expiry). Use amount_lamports or amount_sol."},{"name":"maker_trade_submit","description":"Relay an owner-signed tx for a built trade. Verifies sha256 message-hash matches what we built + owner ed25519 signature; rejects foreign/forged txs and replays. Still NEVER stores private keys — only the signed payload for relay."},{"name":"maker_trades_list","description":"List non-custodial trades (built|confirmed|failed|expired)."},{"name":"maker_trade_get","description":"Get one non-custodial trade by id (status, signature, quote)."},{"name":"maker_chains_list","description":"List Maker chains (solana always; robinhood when MAKER_RH_CHAIN_ENABLED). Includes capabilities summary."},{"name":"maker_chain_enablement","description":"Robinhood enablement matrix: chainEnabled, writeGo, bridgeEnabled, writeReady, blockers."},{"name":"maker_chain_capabilities","description":"Chain-specific capabilities: inclusion fee (Jito tip vs ETH gas), swap venue (Jupiter vs Uniswap), warmup mode, privacy rail, DexScreener chainId. Use before applying Solana knobs to RH."},{"name":"maker_token_resolve_chain","description":"Given a token mint/0x address, detect chain via shape + DexScreener (solana|robinhood). Call before strategy/warmup when user pastes a contract."},{"name":"maker_warmup_plan","description":"Chain-specific warmup plan only (does not start job). Solana=Jupiter+Jito; Robinhood=Uniswap+ETH gas. Rejects jito_tip on RH."},{"name":"maker_bridge_lanes","description":"List SOL↔Robinhood bridge lanes (third-party rails; protocol fee 0). Requires MAKER_RH_BRIDGE_ENABLED."},{"name":"maker_bridge_plan","description":"Prepare SOL↔RH bridge plan (prepare→owner_sign→submit→track). No team intermediate wallet. Privacy Cash is SOL-only — pure RH privacy invalid."},{"name":"maker_bridge_private_fund_plan","description":"Multi-leg private fund: RH→SOL bridge → Privacy Cash → optional SOL→RH. Privacy Cash is SOL-only."},{"name":"maker_rh_trade_build","description":"Build UNSIGNED Uniswap swap on Robinhood Chain (4663). No Jito — ETH gas. Returns intent_hash; MVP sign as signed:<hash>. Requires MAKER_RH_CHAIN_ENABLED."},{"name":"maker_rh_trade_submit","description":"Submit RH trade intent. MVP signature: signed:<intent_hash>. Optional signed_data must match unsigned.data."},{"name":"maker_rh_trades_list","description":"List Robinhood non-custodial trade intents for this org."},{"name":"maker_rh_wallets_list","description":"List Robinhood wallets (external_rh / worker_rh) for this org."},{"name":"maker_rh_dex","description":"Verify live Uniswap V2 on Robinhood Chain (4663): router, factory, WETH. Free public read when chain enabled."},{"name":"maker_rh_swap_quote","description":"LIVE Uniswap V2 quote on Robinhood (on-chain getAmountsOut). side: eth_to_token|token_to_eth|token_to_token. No broadcast."},{"name":"maker_rh_mm_cycle","description":"RH market-making cycle via Uniswap V2: ETH→token→ETH. dry_run=true (default) = live quotes only. dry_run=false needs custodial wallet_id + ETH gas (WRITE_GO)."},{"name":"maker_funding_session","description":"Create SOL deposit address for this org/session. User sends SOL here; watcher credits available_sol. Always SOL-only intake."},{"name":"maker_funding_session_get","description":"Get deposit session status + org available_sol."},{"name":"maker_funding_balance","description":"Org available SOL credit (from deposits)."},{"name":"maker_funding_allocate","description":"FUND workers via private rail (never public hop). DEFAULT = deposit ONCE to session, then STAGGERED drip to many wallets: random amount_range_sol (default 0.08–0.45), fund_spacing_minutes default 1–1440 (1 min–24h, user-overridable), fund_shuffle_wallets=true, asymmetric shield≠withdraw. fund_per_day 1–8. wallet_ids array or 'all_unfunded'. ALWAYS pass a human-descriptive name."},{"name":"maker_warmup","description":"WARMUP: season wallets with buy/hold/sell. FULLY CUSTOMIZABLE. Optional tokens/contracts list (weighted mints); if omitted uses high-volume discovery. Ranges: days (3-5), activities_per_day (1-2), hold_hours (1-48), sell_pct (97-100), notional_sol, slippage_bps. ALWAYS pass a human-descriptive name (e.g. 'Warmup 3 wallets · discovery · 3-5 days'). Job not complete until sell legs done."},{"name":"maker_strategy_create","description":"Create MM strategy on a token. REQUIRED: token_mint + wallet_ids (custodial workers). Optional template (default balanced_mm). Pass ANY StrategyParams as top-level ranges OR overrides{} — full list from maker_list_templates.all_strategy_params. For volume: template=volume_trader and follow volume_trader_playbook (short position_hold_hours, fast take_profit_pct + high take_profit_inventory_pct/sell_pct, modest notional_per_trade_sol, max_notional_per_hour_sol cap, daily_loss_limit_sol). Modes: market_make / buy_dip / buy_into_flow / sell_into_flow + auto TP. ALWAYS pass a human-descriptive name (e.g. 'balanced_mm · mint AbC… · 3 wallets · 3-5d'). After create → maker_strategy_start. Does not move funds by itself."},{"name":"maker_strategy_list","description":"List all strategies for the org."},{"name":"maker_strategy_get","description":"Get strategy status: params, inventory, hourly budget used, organic flow signals, campaign_ends_at."},{"name":"maker_strategy_start","description":"Start or resume a strategy (begins quoting / dip / flow modes per template)."},{"name":"maker_strategy_pause","description":"Pause strategy (no new risk; inventory held)."},{"name":"maker_strategy_stop","description":"Stop strategy (campaign end path; settle separately via flatten if needed)."},{"name":"maker_strategy_patch","description":"LIVE override any strategy ranges while running (volume/hour, spreads, TP, dip, organic, campaign duration, slippage, jito tip). Cannot change token_mint or wallet_ids. Prefer overrides{} object."},{"name":"maker_strategy_flatten","description":"Reduce inventory. amount range (default 90-100% inventory) + execution_duration range (paced exit)."},{"name":"maker_command_buy","description":"Discretionary BUY on a strategy (POST /v1/strategies/:id/commands/buy). REQUIRED ranges: amount {min,max,unit:sol} and execution_duration {min,max,unit:minutes|hours|days}. Optional slippage_bps + jito_tip_lamports. ALWAYS pass a human-descriptive name. Creates a command_buy job — poll maker_job_status."},{"name":"maker_command_sell","description":"Discretionary SELL on a strategy (POST /v1/strategies/:id/commands/sell). REQUIRED ranges: amount + execution_duration. Optional sell_pct 97-100 for residual dust, slippage_bps, jito_tip_lamports. Creates a command_sell job. ALWAYS pass a human-descriptive name."},{"name":"maker_roi","description":"RESULTS & ROI across jobs and strategies you started. Returns summary (total realized_pnl_sol, open inventory, hourly/daily volume, rough roi_pct), by_template rollup (compare volume_trader vs buy_low_take_profit etc.), per-strategy results (pnl, inventory, volume, last organic signal, params snapshot), and per-job outcomes (status, progress, activity stats, fund/withdraw refs). Filter: strategy_id, job_id, template, kind, since (ISO), limit. Use after campaigns to see what worked. Auth required."},{"name":"maker_jobs_list","description":"List all jobs for your account (status/kind/q filters). Every MM action creates a job with human name, progress, activity trail — use when user asks jobs/what's running/status. Prefer summarizing name + status + progress."},{"name":"maker_job_status","description":"Job detail: name, status, progress {pct,done,total,message}, activity[] trail, next_at, open_positions, complete_when."},{"name":"maker_job_cancel","description":"Cancel job; warmup legs sell ASAP. Does not delete wallets."},{"name":"maker_job_patch","description":"LIVE-EDIT a running/scheduled job after create. Change randomness, speed up, retune amounts, rename. fund_wallets: amount_range_sol, fund_spacing_minutes (1–1440), fund_per_day, fund_spacing_jitter_pct, fund_shuffle_wallets, fund_asymmetric_amounts, speed=fast|default, run_now. create_wallets: create_per_day, create_spacing_minutes. warmup: tokens/contracts, days, hold_hours, notional_*, sell_pct, activities_per_day, slippage/jito. strategy (tick job): pass any StrategyParams (volume_mode, acts_per_hour, spreads, target_makers, …) — applied to linked strategy. command buy/sell: amount, execution_duration, slippage, jito. All kinds: name, next_in_minutes, run_now=true. Cannot patch completed/cancelled jobs."},{"name":"maker_campaign","description":"ONE-SHOT LIFECYCLE: create paced wallets → private fund → warmup → auto-start strategy. Returns deposit_address (send SOL here) + create_job. ALWAYS pass a human-descriptive name (e.g. 'Lifecycle · 5 wallets · mint … · standard'). Templates: lifecycle_standard|lifecycle_fast|lifecycle_stealth_pace."}]},"tools":["maker_capabilities","maker_health","maker_feedback","maker_stats","maker_fees","maker_x402_pricing","maker_list_templates","maker_phoenix_markets","maker_token_lookup","maker_lp_scale_plan","maker_token_intel","maker_strategy_campaign","maker_strategy_recommend","maker_plan","maker_execute_plan","maker_create_api_key","maker_account","maker_list_api_keys","maker_revoke_api_key","maker_wallets_batch","maker_wallets_list","maker_wallet_get","maker_wallet_withdraw","maker_external_wallet_register","maker_trade_build","maker_trade_submit","maker_trades_list","maker_trade_get","maker_chains_list","maker_chain_enablement","maker_chain_capabilities","maker_token_resolve_chain","maker_warmup_plan","maker_bridge_lanes","maker_bridge_plan","maker_bridge_private_fund_plan","maker_rh_trade_build","maker_rh_trade_submit","maker_rh_trades_list","maker_rh_wallets_list","maker_rh_dex","maker_rh_swap_quote","maker_rh_mm_cycle","maker_funding_session","maker_funding_session_get","maker_funding_balance","maker_funding_allocate","maker_warmup","maker_strategy_create","maker_strategy_list","maker_strategy_get","maker_strategy_start","maker_strategy_pause","maker_strategy_stop","maker_strategy_patch","maker_strategy_flatten","maker_command_buy","maker_command_sell","maker_roi","maker_jobs_list","maker_job_status","maker_job_cancel","maker_job_patch","maker_campaign"],"hint":"POST tools/list for full inputSchema; set MCP_PUBLIC_FULL_CATALOG=true to embed schemas on GET"}