loot-agent-mcp
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 buildClaude Code:
claude mcp add loot -- node /path/to/loot-agent-mcp/dist/index.jsClaude Desktop 或 Cursor(mcpServers 配置):
{
"mcpServers": {
"loot": {
"command": "node",
"args": ["/path/to/loot-agent-mcp/dist/index.js"]
}
}
}以上以只读方式运行:每一个写入工具都会告诉你启用交易会解锁什么,而不是隐藏自身。若要启用交易,请添加一个 env 块,其中包含 环境变量示例 中指定的 Agent 钱包密钥变量。该文件说明了每一项设置:钱包密钥、链选择(默认主网 4663,测试网 46630 可选加入)、RPC 与 API 配置覆盖。
工具
读取类(无需启用钱包即可使用)
工具 | 功能 |
| 服务健康状况:链检查、钱包、模式、API 可达性以及当前使用的已部署地址 |
| 从平台源流中发现代币:新币、私募池、已毕业、趋势、快速上涨 |
| 单个代币的实时链上状态:供应量、池、现货价格、发行估值(FDV)、区域、战利品、资金包 |
| 通过真实的 Router 经 |
| 钱包的余额、钥匙、盒子、战利品、待领取的收益池份额,以及当前可领取的密钥大棚群系 |
| 赛季时钟、实时每日奖励排行榜、该钱包的排名 |
写入工具(需要已启用的钱包):
工具 | 功能 |
| 通过已部署的 Router 用 ETH 买入。先获取报价,再要求“报价减去滑点”的结果, Gas 固定,从不估算 |
| 卖出换 ETH,按数量或余额的百分比。不会送达一个未受保护的价格地板,而是拒绝 |
| 在一笔交易中领取所有可领取的密钥家族:每日领取、销毁、毕业、调动、大使、推荐。先模拟,只发送能得到结果的交易 |
| 打开战利品盒子:消耗一把钥匙,等待锁定的 drand round,然后通过链上的公共随机信标结算 |
| 在某个 drand round 发布后,完成任何人的未决开启。结算无需许可,战利品始终计入同一请求者 |
| 领取该钱包待处理的收益池份额。永远以原生 ETH 向调用者支付,任何秒数、任何金额 |
| 一次性领取排行榜奖励、返回 12 小时排名奖励,以及赛季期间的促销钥匙 |
| 完整的代币发行仪式:锁定 metadata,托管 0.01 ETH,获取签名票据,然后做正常发行、致敬发行,或在硬预算内买断名字。提交后任何失败都会自动取消,并退回 0.009 ETH |
安全,清清楚楚
默认链是主网 4663。这是真实资金。请为一个专用钱包只转入 Agent 可以使用的数量。
已部署的合约是无钥的。没有暂停机制,没有 admin 私钥,没有支持工单。错误无法挽回。
服务器每一次发送前都会严格验证 RPC 的 chain id(验证失败即拒绝),固定 gas 费用,并在转入之后,通过已部署的 Router 重新报价,然后再发送。
共享的地址后缀是刻意挖到的地址修饰:协议合约以
5668结尾,代币以1007结尾。这不是伪造,而是一个系列的特征。不要轻信任何代码库或网页所声称的地址,包括本仓库中的信息。本身捆绑的
deployments/清单就是服务器读取的文件;在向地址写入资金之前,请先在 区块链浏览器 或链上独立核实每个地址。
本仓库的内容
此 MCP 服务器的 Agent 使用手册:SKILL.md
Agent 的访问入口: 1007loot.com/llms.txt
文档,一页概览:1007loot.com/docs
Agent 进行代币发行所需的身份认证(类 SIWE 签名验证与 session):文档中的 Agent 章节有详细说明
来源
本仓库是从 LOOT 单仓中的 Agent 模块发布出来的源码镜像,这样 Agent 才能安装。所有地址都来自清单文件,绝不会手动硬编码。随附的 test suite 运行 npm test,会使用 mock transport 进行完整的发送/签名一致性测试,不会发送任何链上交易。
Available Tools
14 toolsloot_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
Scored across 14 tools
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.
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.
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.
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
Robinhood Chain MCP server: memecoin trading for AI agents, rug and honeypot checks, best route. Trade new Robinhood Chain tokens through TRNCH: live screened launch feed, find new gem and memecoin, best route across six routers, rugs and honeypots refused. Non-custodial, the agent's wallet signs.
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
The only x402 MCP server for Robinhood Chain (chainId 4663) - 147 onchain, trading & AI tools.
Read-only MCP server for Robinhood Chain token discovery, research, and due diligence via GMGN.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to interact with PumpSwap for real-time token swaps and automated on-chain trading.7MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to launch, buy, and sell tokens on the Raydium Launchpad(aka LaunchLab).4MIT
- AlicenseCqualityAmaintenanceAn 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.23MIT
- AlicenseAqualityDmaintenanceAn MCP server that lets agents launch and trade coins on cook4.fun, a Uniswap-V3-native launchpad on the Robinhood chain.61MIT