Skip to main content
Glama

loot-agent-mcp

为 LOOT 构建的 MCP 服务器——一个基于 Robinhood Chain(链 ID 4663)的终身战利品游戏。将它接入 Claude、Cursor 或任何 MCP 客户端,你的 Agent 就能交易 LOOT 代币、体验完整游戏循环,并发布自己的代币。Agent 与所有人类钱包使用完全相同的价格和规则,没有上限,也没有 Agent 税。

游戏,一句话

每一个 LOOT 代币都在一个标准的 Uniswap V4 池中交易,其发行位置被永久锁定在我们的 hook 中。持仓并挺过风险期就会生成战利品盒子。这里没有钥匙商店:你玩,钥匙就掉落。钥匙用来开盒子,开出的战利品是该代币手续费池的按比例份额,以 ETH 随时、按任意大小领取。卖出时,对应数量的游戏仓位被销毁。仿盘要么向原版致敬,要么直接买断名字。已部署的协议无需私钥,也无须许可即可使用。

Related MCP server: raydium-launchlab-mcp

快速开始

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 或 Cursor(mcpServers 配置):

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

以上以只读方式运行:每一个写入工具都会告诉你启用交易会解锁什么,而不是隐藏自身。若要启用交易,请添加一个 env 块,其中包含 环境变量示例 中指定的 Agent 钱包密钥变量。该文件说明了每一项设置:钱包密钥、链选择(默认主网 4663,测试网 46630 可选加入)、RPC 与 API 配置覆盖。

工具

读取类(无需启用钱包即可使用)

工具

功能

loot_status

服务健康状况:链检查、钱包、模式、API 可达性以及当前使用的已部署地址

loot_list_tokens

从平台源流中发现代币:新币、私募池、已毕业、趋势、快速上涨

loot_token_state

单个代币的实时链上状态:供应量、池、现货价格、发行估值(FDV)、区域、战利品、资金包

loot_quote

通过真实的 Router 经 eth_call 获取成交时代单报价:精确的 tick 数学、手续费、上限。如果这里 revert,则意味着交易会在有原因的情况下失败

loot_wallet_status

钱包的余额、钥匙、盒子、战利品、待领取的收益池份额,以及当前可领取的密钥大棚群系

loot_standings

赛季时钟、实时每日奖励排行榜、该钱包的排名

写入工具(需要已启用的钱包):

工具

功能

loot_buy

通过已部署的 Router 用 ETH 买入。先获取报价,再要求“报价减去滑点”的结果, Gas 固定,从不估算

loot_sell

卖出换 ETH,按数量或余额的百分比。不会送达一个未受保护的价格地板,而是拒绝

loot_claim_keys

在一笔交易中领取所有可领取的密钥家族:每日领取、销毁、毕业、调动、大使、推荐。先模拟,只发送能得到结果的交易

loot_open_box

打开战利品盒子:消耗一把钥匙,等待锁定的 drand round,然后通过链上的公共随机信标结算

loot_settle_opens

在某个 drand round 发布后,完成任何人的未决开启。结算无需许可,战利品始终计入同一请求者

loot_claim_loot

领取该钱包待处理的收益池份额。永远以原生 ETH 向调用者支付,任何秒数、任何金额

loot_claim_rails

一次性领取排行榜奖励、返回 12 小时排名奖励,以及赛季期间的促销钥匙

loot_launch

完整的代币发行仪式:锁定 metadata,托管 0.01 ETH,获取签名票据,然后做正常发行、致敬发行,或在硬预算内买断名字。提交后任何失败都会自动取消,并退回 0.009 ETH

安全,清清楚楚

  • 默认链是主网 4663。这是真实资金。请为一个专用钱包只转入 Agent 可以使用的数量。

  • 已部署的合约是无钥的。没有暂停机制,没有 admin 私钥,没有支持工单。错误无法挽回。

  • 服务器每一次发送前都会严格验证 RPC 的 chain id(验证失败即拒绝),固定 gas 费用,并在转入之后,通过已部署的 Router 重新报价,然后再发送。

  • 共享的地址后缀是刻意挖到的地址修饰:协议合约以 5668 结尾,代币以 1007 结尾。这不是伪造,而是一个系列的特征。

  • 不要轻信任何代码库或网页所声称的地址,包括本仓库中的信息。本身捆绑的 deployments/ 清单就是服务器读取的文件;在向地址写入资金之前,请先在 区块链浏览器 或链上独立核实每个地址。

本仓库的内容

来源

本仓库是从 LOOT 单仓中的 Agent 模块发布出来的源码镜像,这样 Agent 才能安装。所有地址都来自清单文件,绝不会手动硬编码。随附的 test suite 运行 npm test,会使用 mock transport 进行完整的发送/签名一致性测试,不会发送任何链上交易。

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.

    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