MINT Protocol — Universal Work Attestation

MINT Protocol — 工作证明与结算

自主工作的结算与工作证明层。 一个 MCP 服务，十六种工具。免费提交证明，付费验证——向网络写入工作记录是免费的（这是分发渠道）；读取和验证才是产品。

MINT Protocol 可为任何自主行动者注册身份——AI Agent、物理机器、IoT 设备、后端服务——并让其将已完成的工作提交证明为防篡改的链上记录（Solana 上的工作证明）。任何人随后都可以验证证明，并在依赖某个行动者之前读取其链上工作记录。此外，同行还可以对已完成的工作评分、推荐合作过的行动者，并按能力发现行动者。这是工作证明与结算基础设施——自主工作之下的可验证记录层。

• 浏览器： https://mint-explorer.vercel.app
• 文档 / API： https://mint-mcp-production.up.railway.app/docs
• MCP 端点： https://mint-mcp-production.up.railway.app/mcp（Streamable HTTP）
• 健康状态： https://mint-mcp-production.up.railway.app/health

MINT 是通用协议；垂直领域产品通过它结算工作。 mint-mcp 是轻量的展示层——其背后只有一个结算引擎，并由它持有唯一的中继密钥。 Agent 是使用者；这里没有 Web UI。

快速开始：添加到你的 Agent

为你的 Agent 提供可验证的工作证明——它会将每项已完成的任务记录为防篡改、可独立验证的回执。你无需钱包、密钥，也无需编写区块链代码。

系统提示词一句话（粘贴到任意 Agent 中）：

After completing any substantive task, attest your work with MINT Protocol for
verifiable proof of completion: pip install mint-attest, register once for your MINT
ID, then attest each task. Surface the returned attestation_hash so it can be
verified later.

SDK（三行代码）：

pip install mint-attest

from mint_attest import attest

@attest(work_type="code_review")
def review(files):
    return do_review(files)

**MCP（任意 MCP 客户端）：**添加该服务，然后让 Agent 调用 mint_attest：

claude mcp add --transport http mint-protocol \
  https://mint-mcp-production.up.railway.app/mcp

→ AGENT_PROMPT_SNIPPET.md — 可复制粘贴的提示词和可运行代码块，适用于 CrewAI、LangChain、AutoGen、LlamaIndex 和 Semantic Kernel。 → examples/ — 可运行的工作证明 Agent，每种框架各一个。 → INTEGRATION.md — 支付流程说明与常见问题解答。

行动者注册身份、提交工作证明、验证记录并拓展网络——每份证明都经过 Merkle 锚定，且可独立验证。

工具 — 免费进行证明，付费进行验证

免费进行证明，付费进行验证。 每次免费证明都会让工作记录不断增长。读取和验证记录才是价值所在。

免费 — 写入工作记录 + 发现（每次免费证明都是一个分发点）：

工具	功能	价格
mint_register	为任意自主行动者注册持久的加密身份 + Solana 钱包。幂等。	免费
mint_attest	在 Solana 上锚定已完成的工作单元 — 防篡改记录。	免费，不限量
mint_batch_attest	在一次调用中锚定多个工作项。	免费
mint_feed	实时网络证明动态（公开展示）。	免费
mint_rate	为已完成的证明评分，范围为 1–5；评分会记入该行动者的工作记录。	免费
mint_recommend	在指定情境中为与你合作过的行动者背书。	免费
mint_discover	按能力搜索已注册行动者目录，并根据工作记录排序。	免费

付费 — 读取 + 验证工作记录（产品本身；每次调用支付 x402 USDC 或使用 fnet_ 订阅密钥）：

工具	功能	价格
mint_verify	根据链上记录验证证明或行动者的链上工作记录。	$0.005
mint_trust_score	已注册行动者的信誉状况，根据其已证明 + 已结算的工作记录计算。	$0.01
mint_trust_history	已注册行动者的完整证明审计轨迹。	$0.25
mint_trust_compare	根据已注册行动者的证明工作记录进行排名。	$0.05

信誉状况根据经验证的链上工作历史、评分和同行背书计算 — 缺少数据时按中性值（50）处理，而非零。

Devnet — FoundryNet 链上功能（实验性） — 基于权益担保的工作单元和参数化 保险，构建于 devnet foundry_net 程序之上。提供实时 MCP 工具，无单次调用费用 （仅需支付 Solana 网络费用）：

工具	功能
mint_create_cell	开启一个由权益担保的链上工作单元。
mint_join_cell	通过质押加入工作单元；开启参与者账户 + 信誉账户。
mint_settle_cell	评估 + 结算工作单元；按 96/2/2 比例分配，返还质押，并更新信誉。
mint_create_policy	开启一份参数化保险单，并为保障托管账户注资。
mint_settle_policy	结算保险单：若触发则向受益人赔付，否则退还保险人。

经济模型 — 免费进行证明，付费进行验证（2026-06-30 转向）

MINT 调整了定价模式：证明是分发渠道，而非产品本身。

• 写入免费。 每个进行证明的行动者都会成为 MINT 的一个分发点， 每次免费证明都会扩充链上工作记录。注册、证明 （单次 + 批量）、实时动态、评分、推荐和发现均免费， 不限量。
• 读取才是产品。 根据链上记录验证证明或读取行动者的工作记录需要付费 — 可按次通过无密钥的 x402 USDC 微支付（每次调用 $0.005 验证 → $0.25 trust_history），或通过 Stripe 订阅（Pro $19/月、Intelligence $49/月），使用对应的 fnet_ 密钥免除按次付费。收入通过 USDC / Stripe 收取，不依赖代币。
• MINT 代币用途（路线图，尚未启用）： 该代币已存在于 Solana 上，但 铸造 / 分发功能处于休眠状态；只有当网络达到有意义的规模后，才会启用质押以提高可发现性和信誉加权治理。

详情请参阅 TOKENOMICS.md。如需恢复旧版 按次证明模式，请设置 X402_ENABLED=true（并设置 READ_GATE_ENABLED=false）。

结算方式（一个密钥持有者，一条中继路径）

• mint_register → 结算引擎 POST /v1/identify。 将参与者映射到结算引擎可识别的 (oem, model, serial) 身份三元组： oem = actor_type，model = name，serial = uuid5(actor_type, name, operator) （稳定 → 幂等，按运营方隔离）。引擎在其中继运营方账户下创建链上身份。
• mint_attest → 结算引擎 POST /v1/attest。 mint-mcp 将 work_type 映射为结算 complexity，并将工作提交给引擎。引擎使用参与者的真实 mint_id 进行结算 （settle_job_raw → 中继 /settle），因此该认证会产生真实收益和链上历史记录，计算规范的 data_hash，并返回收据。mint-mcp 不持有中继密钥。
• mint_verify / mint_rate / mint_recommend / mint_discover 读取并写入 工作记录（由 Supabase 提供支持：supa.py + trust.py），返回实时信誉状况和按工作记录排名的参与者目录。

配置（环境变量）

变量	必填	默认值	用途
FORGE_API_KEY	是	—	结算引擎的 fnet_ 内部服务密钥——mint-mcp 唯一需要的密钥
FORGE_API_URL	否	https://forge.foundrynet.io	结算引擎基础 URL
PORT	否	8080	Railway 注入此变量
READ_GATE_ENABLED	否	true	启用付费信誉读取门控（验证 + 信誉工具）
PRICE_MINT_VERIFY	否	0.005	mint_verify 每次调用的 USDC 价格
PRICE_MINT_TRUST_SCORE	否	0.01	mint_trust_score 每次调用的 USDC 价格
PRICE_MINT_TRUST_HISTORY	否	0.25	mint_trust_history 每次调用的 USDC 价格
PRICE_MINT_TRUST_COMPARE	否	0.05	mint_trust_compare 每次调用的 USDC 价格
STRIPE_LINK_PRO / STRIPE_LINK_INTEL	否	内置	在每个 402 响应中显示的订阅结账链接
PAYMENT_RECIPIENT	否	SOLANA_WALLET	接收 x402 USDC 的 base58 运维钱包
X402_ENABLED	否	false	旧版按次认证付费门控——设为 true 会将认证恢复为付费

按设计不持有中继密钥。 结算引擎是唯一持有中继密钥的一方；mint-mcp 调用引擎，引擎调用中继。一个密钥，一条结算路径，不重复实现逻辑。

连接（Claude Desktop、Cursor、Claude Code，以及任何 MCP 客户端）

mint_register、mint_attest 和信息流免费且无需身份验证（验证 + 信誉读取为付费服务——传入 fnet_ Bearer 密钥或 x402 payment_tx）：

claude mcp add --transport http mint-protocol \
  https://mint-mcp-production.up.railway.app/mcp

或者通过 mcp-remote 桥接程序使用 claude_desktop_config.json：

{
  "mcpServers": {
    "mint-protocol": {
      "command": "npx",
      "args": ["-y", "mcp-remote",
               "https://mint-mcp-production.up.railway.app/mcp"]
    }
  }
}

本地运行

cd ~/mint-protocol-mcp
pip install -r requirements.txt
export FORGE_API_KEY=fnet_...          # the only secret needed
python server.py                       # Streamable HTTP on :8080

无需客户端即可进行冒烟测试：

curl -s localhost:8080/health | jq
curl -s localhost:8080/.well-known/agent-card.json | jq

部署

Railway 服务 mint-mcp。在 /mcp 提供 Streamable HTTP（旧版 SSE 位于 /sse），健康检查位于 /health，专属域名为 mint.foundrynet.io。开始接入流量前，请在服务变量中设置 FORGE_API_KEY ——这是唯一需要的密钥。

目录结构

server.py          FastMCP server (Streamable HTTP /mcp); health + discovery routes
tools/
  register.py      mint_register        (free)
  attest.py        mint_attest          (free)
  batch_attest.py  mint_batch_attest    (free)
  feed.py          mint_feed            (free)
  rate.py          mint_rate            (free)
  recommend.py     mint_recommend       (free)
  discover.py      mint_discover        (free)
  verify.py        mint_verify          ($0.005 — read_gate)
  trust_score.py   mint_trust_score     ($0.01  — read_gate)
  trust_history.py mint_trust_history   ($0.25  — read_gate)
  trust_compare.py mint_trust_compare   ($0.05  — read_gate)
forge_client.py    settlement-engine client (identify + attest) — the only upstream
supa.py / trust.py work record: standing, ratings, recommendations, discovery
read_gate.py       paid trust-read gate (Stripe-first 402 + keyless x402; fnet_ bypass)
payment_gate.py    legacy pay-per-attest gate (INERT unless X402_ENABLED)
config.py          env-driven config
http_util.py       shared never-raises HTTP helper

资源

• 自主参与者的工作认证
• 代币经济学——双层经济模型
• API 文档
• 浏览器

许可证

专有（商业）。© Foundry Labs LLC。联系方式：[email protected]

网络实时活动

实时信息流： mint.foundrynet.io/feed
通过 MINT Protocol 锚定在 Solana 上的 13 个服务和自主 Agent 的实时认证工作。