Skip to main content
Glama

loot-agent-mcp

MCP server for LOOT, the lifetime loot game on Robinhood Chain (chain id 4663). Plug it into Claude, Cursor, or any MCP client and your agent trades LOOT tokens, plays the full game loop, and launches its own tokens. Agents play at the same prices and rules as every human wallet. No caps, no agent tax.

The game, in one breath

Every LOOT token trades in a canonical Uniswap V4 pool with its launch position locked in our hook forever. Holding through risk mints loot boxes. There is no key shop: you play, keys drop. Keys open boxes, and opened loot is a pro rata claim on that token's fee pot, paid in ETH, any second, any size. Selling burns the game position for the amount sold. Copies pay tribute to the original or buy the name out. The deployed protocol is keyless and permissionless.

Related MCP server: raydium-launchlab-mcp

Quickstart

git clone https://github.com/D-Kek/loot-agent-mcp
cd loot-agent-mcp
npm install && npm run build

Claude Code:

claude mcp add loot -- node /path/to/loot-agent-mcp/dist/index.js

Claude Desktop or Cursor (mcpServers config):

{
  "mcpServers": {
    "loot": {
      "command": "node",
      "args": ["/path/to/loot-agent-mcp/dist/index.js"]
    }
  }
}

That runs read-only: every write tool answers with what arming unlocks instead of hiding. To arm trading, add an env block with the agent wallet key variable named in .env.example, which documents every setting: wallet key, chain selection (mainnet 4663 is the default, testnet 46630 opt-in), RPC and API overrides.

Tools

Reads (work unarmed):

Tool

What it does

loot_status

Server health: chain check, wallet, mode, API reachability, deployed addresses in use

loot_list_tokens

Discover tokens from the platform feed: new, bonding, graduated, trending, rising

loot_token_state

One token's live on-chain state: supply, pool, spot price, FDV, zone, loot, pot

loot_quote

Execution-time quote via the real router through eth_call: exact tick math, fees, caps. A revert here means the trade would fail, with the reason

loot_wallet_status

A wallet's balance, keys, boxes, loot, pending pot share, and which key families are claimable right now

loot_standings

Season clock, live daily prize board, a wallet's rank

Writes (need the armed wallet):

Tool

What it does

loot_buy

Buy with ETH through the deployed router. Quotes first, demands quote minus slippage. Fixed gas, never estimated

loot_sell

Sell for ETH, by amount or percent of balance. Refuses rather than send an unprotected floor

loot_claim_keys

Claim every claimable key family in one call: drips, streak, graduation, knife, referral. Simulates first, only sends what pays

loot_open_box

Open loot boxes: spends a key, waits for the pinned drand round, settles on-chain with the public beacon

loot_settle_opens

Finish anyone's pending opens once their drand round publishes. Settlement is permissionless; loot always credits the requester

loot_claim_loot

Claim the wallet's pending pot share. Native ETH to the caller, any second, any size

loot_claim_rails

Claim daily prize boards, the 12h rank drip, and season promo keys in one pass

loot_launch

The full launch ceremony: pin metadata, escrow 0.01 ETH, get the signed ticket, then launch clean, launch as tribute, or buy the name out under a hard budget. Any failure after submit auto-cancels for the 0.009 ETH refund

Safety, plainly

  • Default chain is mainnet 4663. Real money. Fund a dedicated wallet with only what the agent should play with.

  • The deployed generation is keyless. No pause, no admin key, no support ticket. Mistakes are permanent.

  • The server verifies the RPC's chain id fail-closed before every send, pins fixed gas, and quotes through the deployed router before trading.

  • The shared address endings are deliberate CREATE2 vanity mining: protocol contracts end in 5668, tokens end in 1007. A family signature, not fabrication.

  • Do not take any repo or web page as the truth about addresses, this one included. The bundled deployments/ manifests are the same files the server reads; verify every address independently on the explorer and against the chain before wiring funds.

Where things live

Provenance

This repo is a source mirror of the agent package from the LOOT monorepo, published so agents can install it. Addresses are manifest-pinned, never hand-typed. The test suite ships with it; npm test runs the full sign-and-send parity suite against mock transports, nothing on-chain.

Available Tools

14 tools
loot_buyA

Buy a LOOT token with ETH through the deployed router. Quotes the exact trade first via eth_call and demands the quote minus slippage_bps (default 200). Fixed 5,000,000 gas, never estimated. Needs LOOT_AGENT_PRIVATE_KEY.

Inputs: token (required), eth_in (required), slippage_bps, deadline_seconds.

loot_claim_keysA

Claim every key family that is claimable right now for a token: universal drip, streak, token drip, graduation, knife, and referral keys. Simulates each claim first and only sends the ones that would pay. Fixed gas per family, granted counts read from the receipts. Needs LOOT_AGENT_PRIVATE_KEY.

Inputs: token (required).

loot_claim_lootA

Claim this wallet's pending pot share for a token from the ledger. Pays native ETH to the caller, any second, any size. The claimed amount is read from the receipt's Claimed event. Needs LOOT_AGENT_PRIVATE_KEY.

Inputs: token (required).

loot_claim_railsA

Claim everything this wallet can from the trader rails: recent closed daily prize boards (simulated first, only paying days are sent), the 12h rank drip, and any season promo keys. The v3 era cashback lane does not exist on v4. Needs LOOT_AGENT_PRIVATE_KEY.

Inputs: days_back.

loot_launchA

Launch a new LOOT token through the factory ceremony. Pins metadata via the loot API, escrows 0.01 ETH plus any dev buy on-chain with submit, gets the signed launch ticket, then acts by policy: clean_only cancels if the draft matches a live protected root, tribute_ok accepts launching as a tribute copy, buyout pays the live on-chain quote up to max_buyout_wei (a hard budget) to take the name over. Any mismatch, ticket expiry or failure after submit auto-cancels for the 0.009 ETH refund plus the dev buy; the factory keeps 0.001 ETH for the check. Needs LOOT_AGENT_PRIVATE_KEY and LOOT_API_URL.

Inputs: name (required), policy (required), ticker (required), image, +3 more.

loot_list_tokensC

Discover LOOT tokens from the platform feed. Filters: new, bonding (pre-graduation), graduated, trending, rising, all. Optional search and sorting. Needs LOOT_API_URL.

Inputs: limit, filter, search, sort_by, +1 more.

loot_open_boxA

Open loot boxes: spends one key of the chosen tier plus a slice of the unopened box pile now, waits for the pinned drand round, fetches the public beacon, and settles on-chain. Key source auto prefers a token-scoped key and falls back to a universal key. Reports the settled tier counts and loot minted. Needs LOOT_AGENT_PRIVATE_KEY.

Inputs: token (required), tier, key_source.

loot_quoteA

Execution-time quote from the real router via eth_call: exact tick math, fees, and caps for the calling wallet. side buy takes amount_eth, side sell takes amount_tokens. A revert here means the trade would fail and the reason is reported.

Inputs: side (required), token (required), from, amount_eth, +1 more.

loot_sellA

Sell a LOOT token for ETH through the deployed router. Takes amount_tokens (decimal) or percent of the wallet balance. Approves the router once if needed, quotes the exact sell, and refuses rather than send an unprotected floor. Fixed 5,000,000 gas. Needs LOOT_AGENT_PRIVATE_KEY. Selling burns the game position for the amount sold.

Inputs: token (required), percent, slippage_bps, amount_tokens, +1 more.

loot_settle_opensA

Finish pending box opens: submitOpen is permissionless, so any wallet can settle any request once its drand round is published. Pass ids, or let it scan the newest requests on the ledger. Skips settled requests and rounds that are not published yet. Needs LOOT_AGENT_PRIVATE_KEY (to send; the opened loot always credits the requesting wallet).

Inputs: ids, wallet, scan_last.

loot_standingsA

Season clock and the live daily prize board from the public tRPC lanes. Pass wallet for that wallet's season rank and daily standing. Pass day (YYYY-MM-DD) for a past day's final board. Needs LOOT_API_URL.

Inputs: day, wallet.

loot_statusA

Server health and configuration: chain id, RPC chain check, wallet address and balance, armed or read-only mode, API reachability, and the deployed contract addresses in use.

Inputs: no named parameters.

loot_token_stateA

One token's live on-chain state: name, supply, pool, spot price from the pool itself, FDV, and the game ledger state (zone, loot, pot). Chain reads only, no API needed.

Inputs: token (required).

loot_wallet_statusB

A wallet's ETH balance, universal keys, welcome state, and (with token) its full game position: token balance, unopened boxes, loot, pending pot share, player record, and which key families are claimable right now. Chain reads only.

Inputs: token, wallet.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 14 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: status checks, token discovery, live state, quotes, wallet positions, trade execution, claims, box mechanics, and launching. No two tools overlap in purpose; even similar actions like claim_keys, claim_loot, and claim_rails are clearly differentiated by what they claim.

    Naming Consistency5/5

    All tools share the 'loot_' prefix and use a clear verb_noun or noun-only structure (e.g., loot_list_tokens, loot_buy, loot_claim_keys, loot_token_state). The pattern is predictable and consistent, with no mixed conventions or vague verbs.

    Tool Count5/5

    14 tools is well‑scoped for a trading and game-state agent: it covers discovery, state, quotes, execution, claims, box operations, settlement, and launching without excess. Each tool adds a necessary function and none feels redundant.

    Completeness5/5

    The set provides full lifecycle coverage for the LOOT platform: explore tokens, inspect state, quote, buy/sell, claim keys and loot, open boxes, settle opens, claim rails, and launch new tokens. There are no obvious dead ends; every action has corresponding read tools and actionable operations.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      A
      maintenance
      An MCP server that gives AI agents real-time market data, DeFi intelligence, and automatic tool discovery via plugins. Supports x402 micropayments and is always updated.
      23
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that lets agents launch and trade coins on cook4.fun, a Uniswap-V3-native launchpad on the Robinhood chain.
      6
      1
      MIT