MolTrust MCP Server

MolTrust MCP Server

适用于 MolTrust 的 MCP 服务 — AI Agent 信任基础设施。

托管端点 https://api.moltrust.ch/mcp 提供 61 个工具，涵盖 13 个领域：身份与凭证、链上信任评分、授权符合性、群体智能、已验证徽章、自主商业、预订信任、Agent 技能验证、预测市场往绩记录、梦幻阵容承诺、音乐来源追溯、品牌与经销商来源追溯，以及 Amazon Ads 判定 — 全部通过 Model Context Protocol 提供。pip 软件包包含其中 48 个；MolCheck 验证器工具和 Amazon Ads 工具仅在托管端点运行。

工具

身份与凭证（11 个工具）

• moltrust_claim_deposit — 从 Base 上的 USDC 存款申领 MolTrust 额度。
• moltrust_credential — 签发或验证 W3C 可验证凭证。
• moltrust_credits — 管理 MolTrust 额度：查询余额、查看定价、转移额度或查看交易历史记录。
• moltrust_deposit_history — 获取 Agent 的 USDC 存款历史记录。
• moltrust_deposit_info — 获取购买 MolTrust 额度所需的 USDC 存款说明。
• moltrust_erc8004 — 查询 Base 上的 ERC-8004 链上 Agent 注册表。
• moltrust_rate — 为另一个 AI Agent 评分（1–5 星）。
• moltrust_register — 在 MolTrust 上注册新的 AI Agent。
• moltrust_reputation — 获取 AI Agent 的信誉分数。
• moltrust_stats — 获取 MolTrust 网络统计信息。
• moltrust_verify — 通过 DID 验证 AI Agent。

MoltGuard — Agent 信任评分（7 个工具）

• moltguard_credential_issue — 为钱包签发 W3C 可验证凭证（AgentTrustCredential）。
• moltguard_credential_verify — 验证 MoltGuard 可验证凭证的 JWS 签名。
• moltguard_detail — 获取 Base 钱包地址对应 Agent 的详细信任报告。
• moltguard_feed — 获取异常动态榜首 — 完整性问题最严重的市场。
• moltguard_market — 检查 Polymarket 预测市场是否存在完整性异常。
• moltguard_score — 获取 Base 钱包地址对应 Agent 的信任分数。
• moltguard_sybil — 扫描 Base 钱包，查找女巫攻击指标。

MolCheck 验证器 — 授权符合性（5 个工具，仅限托管端点）

• molcheck_evidence — 判定结果以及违反授权的已解码交易。
• molcheck_mandate — Agent 已提交的 AAE 授权（场所、持仓上限、有效期）。
• molcheck_registry — 已提交授权的 Agent 及其当前判定结果。
• molcheck_verdict — 根据 Agent 已提交的授权给出判定结果和逐项检查明细。
• molcheck_verify — 根据公开输入重新计算判定结果并检查其签名。

旧名称 moltproof_evidence、moltproof_mandate、moltproof_registry、moltproof_verdict 和 moltproof_verify 仍可作为这些工具的弃用别名使用，因此 tools/list 在此处会显示 10 个条目。

群体智能（4 个工具）

• mt_get_swarm_graph — 获取 Agent 的信任传播图（2 跳）。
• mt_get_swarm_stats — 获取群体智能的全局统计信息。
• mt_get_trust_score — 获取 Agent 的群体智能信任分数（第 2 阶段）。
• mt_register_seed — 在群体智能网络中注册受信任的种子 Agent（仅限管理员）。

已验证徽章（3 个工具）

• mt_check_badge — 快速检查：此 Agent 是否已通过 MolTrust 徽章验证？
• mt_get_badge — 获取 Agent 的 MolTrust 已验证徽章状态。
• mt_issue_badge — 为 Agent 颁发 MolTrust 已验证徽章。

MT Shopping — 自主商务（3 个工具）

• mt_shopping_info — 获取 MT Shopping API 信息。
• mt_shopping_issue_vc — 为购物 Agent 颁发 BuyerAgentCredential（W3C 可验证凭证）。
• mt_shopping_verify — 根据 BuyerAgentCredential 验证购物交易。

MT Travel — 预订可信验证（3 个工具）

• mt_travel_info — 获取 MT Travel 服务信息和可用端点。
• mt_travel_issue_vc — 为预订 Agent 颁发 TravelAgentCredential（W3C 可验证凭证）。
• mt_travel_verify — 根据 TravelAgentCredential 验证旅行预订。

MT Skills — Agent 技能验证（5 个工具）

• mt_create_interaction_proof — 在颁发 SkillEndorsementCredential 之前创建交互证明。
• mt_endorse_agent — 为另一个 Agent 颁发 W3C SkillEndorsementCredential。
• mt_skill_audit — 审核 AI Agent 技能（SKILL.md）的安全风险。
• mt_skill_issue_vc — 为 AI Agent 技能颁发 VerifiedSkillCredential。
• mt_skill_verify — 根据 AI Agent 技能的规范 SHA-256 哈希值进行验证。

MT Prediction — 市场记录（3 个工具）

• mt_prediction_leaderboard — 获取预测市场排行榜：按预测分数排名靠前的钱包。
• mt_prediction_link — 关联预测市场钱包并同步其记录。
• mt_prediction_wallet — 获取钱包的预测市场资料和记录。

MT Sports — 梦幻阵容承诺（3 个工具）

• mt_fantasy_commit — 使用锚定在 Base L2 上的 SHA-256 哈希值提交梦幻阵容。
• mt_fantasy_history — 获取 Agent 的梦幻阵容历史记录和统计数据。
• mt_fantasy_verify — 验证梦幻阵容承诺。公共端点，无需身份验证。

MT Music — 溯源（3 个工具）

• mt_get_track_provenance — 获取音乐凭证的完整溯源详情。
• mt_issue_music_credential — 为 AI 生成的音乐曲目颁发 VerifiedMusicCredential。
• mt_verify_music_credential — 根据 VerifiedMusicCredential 的 ID 进行验证。

MT Salesguard — 品牌与经销商溯源（3 个工具）

• mt_salesguard_register — 在 MT Salesguard 注册品牌。
• mt_salesguard_reseller — 通过 MT Salesguard 验证经销商授权。
• mt_salesguard_verify — 通过 MT Salesguard 验证产品溯源。

MT Ads — Amazon Ads 判定（3 个工具，仅托管端点提供）

• ads_check — 在调用执行前，针对一次计划中的 Amazon Ads MCP 工具调用，判定允许／暂缓／禁止。
• ads_mandate_template — 为一个或多个 Amazon Ads 账户构建广告资料及其 AAE 授权。
• ads_onboard — 了解 Agent 如何开始使用 MolTrust Ads：对 Amazon Ads 工具调用作出判定（允许／暂缓／禁止）。

设置

在 api.moltrust.ch/auth/signup 获取 API 密钥。 只读工具也可以在没有密钥的情况下使用。

托管端点（全部 61 个工具）

托管端点为 https://api.moltrust.ch/mcp（可流式传输的 HTTP）。它提供 所有工具，包括 pip 包未包含的 MolCheck 验证器和 Amazon Ads 工具。请在 X-API-Key 标头中发送 API 密钥。

Claude Code：

claude mcp add --transport http moltrust https://api.moltrust.ch/mcp \
  --header "X-API-Key: your_api_key"

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "moltrust": {
      "url": "https://api.moltrust.ch/mcp",
      "headers": { "X-API-Key": "your_api_key" }
    }
  }
}

OpenCode（opencode.json）：

{
  "mcp": {
    "moltrust": {
      "type": "remote",
      "url": "https://api.moltrust.ch/mcp",
      "enabled": true,
      "headers": { "X-API-Key": "your_api_key" }
    }
  }
}

工具列表和架构已发布在 api.moltrust.ch/.well-known/mcp/server-card.json。

本地包（48 个工具）

以下部分介绍如何使用 uvx 通过 stdio 在本地运行 pip 包。该包包含 48 个 工具；MolCheck 验证器和 Amazon Ads 工具仅在托管端点提供。

Claude Code

claude mcp add moltrust -- uvx moltrust-mcp-server

设置 API 密钥：

export MOLTRUST_API_KEY="your_api_key"

或者将其永久添加到 Claude Code：

claude mcp add moltrust -e MOLTRUST_API_KEY=your_api_key -- uvx moltrust-mcp-server

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "moltrust": {
      "command": "uvx",
      "args": ["moltrust-mcp-server"],
      "env": {
        "MOLTRUST_API_KEY": "your_api_key"
      }
    }
  }
}

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

Cursor

添加到 Cursor MCP 设置（.cursor/mcp.json）：

{
  "mcpServers": {
    "moltrust": {
      "command": "uvx",
      "args": ["moltrust-mcp-server"],
      "env": {
        "MOLTRUST_API_KEY": "your_api_key"
      }
    }
  }
}

OpenCode

添加到 opencode.json：

{
  "mcp": {
    "moltrust": {
      "command": "uvx",
      "args": ["moltrust-mcp-server"],
      "env": {
        "MOLTRUST_API_KEY": "your_api_key"
      }
    }
  }
}

pip install（手动）

pip install moltrust-mcp-server

然后运行：

MOLTRUST_API_KEY=your_api_key moltrust-mcp-server

配置

环境变量	默认值	说明
MOLTRUST_API_KEY	—	你的 MolTrust API 密钥（注册、评级、签发时必需）
MOLTRUST_API_URL	https://api.moltrust.ch	API 基础 URL（用于可自托管实例）

示例

连接后，你可以向 AI 助手询问：

• “在 ‘openai’ 平台上注册一个名为 ‘my-assistant’ 的新 Agent”
• “验证 DID 为 did:moltrust:a1b2c3d4e5f60718 的 Agent”
• “did:moltrust:a1b2c3d4e5f60718 的声誉如何？”
• “给 Agent did:moltrust:b2c3d4e5f6071890 评 5 星”
• “获取钱包 0x1234...abcd 的信任评分”
• “扫描钱包 0x1234...abcd，检查是否存在 Sybil 指标”
• “检查 Polymarket 市场 abc123 是否存在异常”
• “为我的购物 Agent 签发 BuyerAgentCredential”
• “根据该 Agent 的凭证验证这笔旅行预订”
• “审计此 Agent 技能是否存在安全风险：https://github.com/example/skill”
• “关联我的 Polymarket 钱包 0x1234...abcd，并显示我的预测评分”
• “显示预测市场排行榜”

开发

git clone https://github.com/MoltyCel/moltrust-mcp-server.git
cd moltrust-mcp-server
pip install -e ".[dev]"

# Lint
ruff check src/
ruff format src/

# Type check
pyright src/

# Test
pytest tests/ -v

安全研究

我们会定期扫描 Agent 基础设施中的安全问题，并发布研究结果：

• 我们扫描了 50 个 Agent 端点——以下是发现 — Agent 生态系统中的常见漏洞及其修复方法

许可证

MIT — CryptoKRI GmbH