AgentRisk M2M

AgentRisk M2M 🛡️

面向 Base 上自主 DeFi Agent 的交易前安全层。 别再让自主交易机器人被隐蔽蜜罐、恶意税费和 Rug Pull 搞得血本无归。

---

⚡ 问题所在

自主交易机器人速度很快，却完全没有风险意识。 每分钟都有未经审查的新代币在 Base 上发行，其中相当一部分是精心设计的陷阱，目的是阻止卖出、榨干执行交易的钱包，或在最糟糕的时刻更改转账税费。 静态黑名单（例如常见的免费 API）无法防范刚部署、经过混淆的合约。等人工整理的名单更新时，你的机器人资金早已不翼而飞。

🎯 解决方案

AgentRisk 是一款隔离的、机器可读的安全 API，专为 AI Agent 和自动化脚本打造。 在机器人于 Uniswap 或 Aerodrome 执行 swap() 之前，它会先向 AgentRisk 发起请求。我们结合直接链上检查、GoPlus Security 和 DexScreener 流动性数据，进行深入的运行时模拟，并返回明确的判定：

{
  "riskScore": 20,
  "riskLevel": "CAUTION",
  "verdict": "PROCEED WITH CAUTION. Top 10 holders control 51.8% of supply.",
  "shouldExecute": true,
  "reasons": [
    "Top 10 holders control 51.8% of supply."
  ]
}

有何不同

• 部署者钱包新旧检测 — 标记用于一次性发行代币的新建钱包
• 品牌冒充检测 — 标记以知名公司（Apple、Google、Meta 等）命名的代币
• 数据源不一致检测 — 标记第三方 API 与我们自身链上检查结果不一致的情况
• 人类可读的判定 — 一句通俗易懂的话，而不只是原始分数
• 亚毫秒级缓存响应 — 30 秒内的重复扫描会即时返回，并附带 cached 字段，让你知道结果是最新的还是复用的

使用 MCP Inspector 快速测试

想在不编写任何代码的情况下试用 MCP 服务？运行：npx @modelcontextprotocol/inspector

然后连接到 https://agentrisk.dev/mcp/manifest，并直接在界面中调用 check_token_risk。

缓存时效性警告

每个响应都包含 cached（布尔值）和 timestamp（Unix 秒）字段。缓存结果最长保留 30 秒——足以加快重复查询的速度，又足够及时，通常能够发现 Rug Pull 或新启用的蜜罐函数。为了在交易执行前进行最后一次安全检查，我们建议使用全新请求，或确认 cached 为 false / timestamp 非常近，然后再信任 shouldExecute: true 的结果。

⚙️ 工作原理（M2M 架构）

1. Agent 通过 mempool 或 DEX 路由器事件发现代币。
2. Agent 调用 AgentRisk MCP 工具（check_token_risk）或直接调用 /scan 端点。
3. 即时 x402 微支付（在 Base 上即时结算 0.15 USDC——无需 API 密钥、订阅或信用卡；纯机器对机器支付）。
4. 二元决策：Agent 收到 shouldExecute: true/false、风险评分和结构化原因。

📦 Python SDK

pip install agentriskm2m

import asyncio
from agentrisk import AgentRisk

async def main():
    risk = AgentRisk(private_key="your_base_wallet_private_key")
    result = await risk.scan("0xTokenAddressHere")
    print(result["verdict"])

asyncio.run(main())

PyPI 页面

或者无需编写代码，直接在终端即时检查代币：

export AGENTRISK_PRIVATE_KEY=your_base_wallet_private_key
agentriskm2m check 0xTokenAddressHere

🚀 复制粘贴即可集成（60 秒）

安装 x402 SDK，然后运行以下代码——它会自动处理付款：

pip install x402 eth-account

import asyncio
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

PRIVATE_KEY = "your_base_wallet_private_key"
TOKEN_ADDRESS = "0x..."  # the token you want to check

async def check_token():
    account = Account.from_key(PRIVATE_KEY)
    client = x402Client()
    register_exact_evm_client(client, EthAccountSigner(account))
    async with x402HttpxClient(client) as http:
        response = await http.get(f"https://agentrisk.dev/scan?token={TOKEN_ADDRESS}")
        print(response.json())

asyncio.run(check_token())

就这样。它会自动支付 0.15 USDC 并打印风险报告。你的钱包需要在 Base 上有少量 USDC 和 ETH（用于支付 Gas）。

框架集成示例

选项 1：MCP（Claude、Cursor，以及任何兼容 MCP 的 Agent）

无需编写代码——只需将 MCP 客户端配置指向：

{
  "mcpServers": {
    "agentrisk": {
      "url": "https://agentrisk.dev/mcp/manifest"
    }
  }
}

你的 Agent 会自动发现 check_token_risk 是一个可用工具。

选项 2：LangChain

from langchain.tools import tool
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

account = Account.from_key("your_base_wallet_private_key")
client = x402Client()
register_exact_evm_client(client, EthAccountSigner(account))

@tool
async def check_token_safety(token_address: str) -> dict:
    """Check if a Base token is a honeypot or scam before buying or swapping."""
    async with x402HttpxClient(client) as http:
        response = await http.get(f"https://agentrisk.dev/scan?token={token_address}")
        return response.json()

# Add check_token_safety to your agent's tools list

选项 3：Coinbase AgentKit

from coinbase_agentkit import action

@action(
    name="check_token_safety",
    description="Check if a Base token is safe to trade before executing a swap"
)
async def check_token_safety(token_address: str) -> dict:
    async with x402HttpxClient(client) as http:
        response = await http.get(f"https://agentrisk.dev/scan?token={token_address}")
        return response.json()

选项 4：纯 Python（适用于任何自定义机器人，无需框架）

def buy_token(token_address, amount):
    risk = check_token_safety(token_address)  # your call to AgentRisk
    if not risk["shouldExecute"]:
        print(f"Blocked: {risk['verdict']}")
        return
    execute_swap(token_address, amount)

选项 5：通过 x402 Bazaar 自动发现

如果你的 Agent 会在 x402 Bazaar 中搜索工具，AgentRisk 会自动被发现——无需手动集成。

🚀 其他集成选项

选项 1：MCP 服务（适用于 Claude、Cursor 和自定义 Agent）

MCP 清单已上线： https://agentrisk.dev/mcp/manifest

工具端点：POST https://agentrisk.dev/mcp/tools/check_token_risk（受 x402 支付门控，每次调用 0.15 USDC）。### 选项 2：直接调用 HTTP

GET https://agentrisk.dev/scan?token=<CONTRACT_ADDRESS>

在附带有效的 x402 付款（Base 上 0.15 USDC）之前，会返回包含付款说明的 HTTP 402。

💰 经济模型

• **模式：**通过 Base 主网上的 x402 协议按次扫描付费。
• **费用：**每次全面扫描 0.15 USDC。
• **支付协调方：**Coinbase 官方 CDP 支付协调方——直接在 Base 上验证并结算付款。

🔎 实时状态

• Agent 清单：/​.well-known/agent.json
• MCP 清单：/mcp/manifest
• 公开记录：/v1/track-record
• 已列入 x402 Bazaar——任何搜索代币安全工具的 Agent 都可以发现

专为信任数学而非炒作的自主系统打造。