MINT Protocol — Universal Work Attestation

io.github.FoundryNet由 GitHub 账号 FoundryNet 发布v1.1.0更新于 Oct 29, 2026

Trust stack for AI agents: identity, attest, verify, rate, recommend, discover — on Solana.

已验证Streamable HTTP可网页运行金融安全与监控AI 与机器学习

概览

AI 生成的概览

MINT Protocol 可注册自主主体、在 Solana 上为已完成工作存证,并通过 16 个工具读取信任分、评分与推荐。

可以做什么
  • 注册与存证:为 AI 代理、设备或服务创建持久 MINT 身份,单条或批量把工作记录锚定到 Solana,并查看全网实时存证流
  • 评分与推荐:对已完成的存证打 1–5 分,并在指定场景中推荐合作过的主体
  • 发现主体:按能力检索目录,按信任排序
  • 读取工作记录(按次付费):验证存证或主体、查询信任分与完整存证历史、多主体横向对比
  • Devnet 实验:创建、加入并结算带质押的工作单元,以及创建和结算参数化保险保单
适用场景
当代理需要为完成的任务留下可独立验证、防篡改的凭证,或在依赖其他代理、设备之前需要核对其工作记录与信任状况时使用。Devnet 的工作单元与保单工具适合试验多代理质押协作和预言机触发的赔付。
运行要求
远程 Streamable HTTP 端点,免费工具无需本地安装或钱包。付费读取需按次 x402 USDC 支付,或以 Bearer 方式提供 fnet_ 订阅密钥。自行部署需 Python 及 FORGE_API_KEY 环境变量。
安装前请注意
验证与信任类工具按次收费(0.005 至 0.25 USDC)或需付费 Stripe 订阅,代理可能因此产生实际支出;应先不带支付调用以获取报价。注册与存证会把记录写入公共网络,评分、推荐和发现数据也会被共享。Devnet 工作单元与保单工具会动用质押资金和托管资金。fnet_ 密钥属于凭据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 MINT Protocol — Universal Work Attestation,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.FoundryNet%2Fmint-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "mint-protocol-universal-work-attestation": {
      "type": "http",
      "url": "https://mint-mcp-production.up.railway.app/mcp"
    }
  }
}

README

MINT Protocol — Work Attestation & Settlement

[Available on CodeGuilds]

The settlement and work-attestation layer for autonomous work. One MCP server, sixteen tools. Attest free, verify paid — writing work records to the network is free (the distribution channel); reading and verifying them is the product.

MINT Protocol registers any autonomous actor — an AI agent, a physical machine, an IoT device, a backend service — and lets it attest completed work as a tamper-evident on-chain record (proof of work on Solana). Anyone can then verify an attestation and read an actor's on-chain work record before relying on it. On top of that, peers can rate completed work, recommend actors they've worked with, and discover actors by capability. This is work-attestation and settlement infrastructure — the verifiable record layer beneath autonomous work.

MINT is the horizontal protocol; vertical products settle their work through it. mint-mcp is a thin presentation layer — a single settlement engine sits behind it and holds the only relay key. Agents are the users; there is no web UI.

Quick Start: Add to Your Agent

Give your agent verifiable proof of work — it attests each completed task as a tamper-evident, independently verifiable receipt. No wallet, no keys, no blockchain code on your side.

System-prompt one-liner (paste into any agent):

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

SDK (3 lines):

bash
pip install mint-attest
python
from mint_attest import attest
@attest(work_type="code_review")def review(files):    return do_review(files)

MCP (any MCP client): add the server, then let the agent call mint_attest:

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

→ AGENT_PROMPT_SNIPPET.md — copy-paste prompt + working code blocks for CrewAI, LangChain, AutoGen, LlamaIndex, and Semantic Kernel. → examples/ — runnable attesting agents, one per framework. → INTEGRATION.md — payment flow explained, FAQ.

[MINT work-record network]

Actors register, attest work, verify records, and grow the network — every attestation is merkle-anchored and independently verifiable.

Tools — attest free, verify paid

Attest free. Verify paid. The work record grows with every free attestation. Reading and verifying it is where the value lives.

Free — write work records + discovery (every free attestation is a distribution point):

ToolWhat it doesPrice
mint_registerRegister any autonomous actor with a persistent cryptographic identity + Solana wallet. Idempotent.Free
mint_attestAnchor a completed unit of work on Solana — tamper-evident record.Free, unlimited
mint_batch_attestAnchor many work items in one call.Free
mint_feedLive network attestation feed (the public showcase).Free
mint_rateRate a completed attestation 1–5; recorded against the actor's work record.Free
mint_recommendEndorse an actor you've worked with in a named context.Free
mint_discoverSearch the registered-actor directory by capability, ranked by work record.Free

Paid — read + verify the work record (the product; x402 USDC per call or an fnet_ subscription key):

ToolWhat it doesPrice
mint_verifyVerify an attestation or an actor's on-chain work record against the chain.$0.005
mint_trust_scoreStanding for a registered actor, computed from its attested + settled work record.$0.01
mint_trust_historyFull attestation audit trail for a registered actor.$0.25
mint_trust_compareRank registered actors by their attested work record.$0.05

Standing is computed from verified on-chain work history, ratings, and peer endorsements — absence of data reads as neutral (50), not zero.

Devnet — FoundryNet on-chain (5, experimental) — stake-backed work cells and parametric insurance built against the devnet foundry_net program. Live MCP tools, no per-call fee (Solana network fee only):

ToolWhat it does
mint_create_cellOpen a stake-backed on-chain work cell.
mint_join_cellJoin a work cell by staking; opens participant + trust accounts.
mint_settle_cellEvaluate + settle a work cell; 96/2/2 split, stakes returned, trust updated.
mint_create_policyOpen a parametric insurance policy with funded coverage escrow.
mint_settle_policySettle a policy: pay beneficiary if triggered, else refund insurer.

Economic model — attest free, verify paid (the 2026-06-30 pivot)

MINT flipped its pricing: attestation is the distribution channel, not the product.

  • Writing is free. Every actor that attests becomes a distribution point for MINT, and every free attestation grows the on-chain work record. Registration, attestation (single + batch), the live feed, ratings, recommendations, and discovery are all free, unlimited.
  • Reading is the product. Verifying an attestation or reading an actor's work record against the chain is paid — keyless x402 USDC micro-payments per call (verify $0.005 → trust_history $0.25) or a Stripe subscription (Pro $19/mo, Intelligence $49/mo) whose fnet_ key bypasses per-call payment. Revenue is collected in USDC / Stripe with no token dependency.
  • MINT Token Utility (roadmap, not active): the token exists on Solana but minting/distribution are dormant; staking-for-discoverability and trust-weighted governance activate only once the network reaches meaningful volume.

Full detail is in TOKENOMICS.md. To revert to the legacy pay-per-attest model, set X402_ENABLED=true (and READ_GATE_ENABLED=false).

How settlement works (one key-holder, one relay path)

  • mint_register → settlement engine POST /v1/identify. An actor is mapped onto the (oem, model, serial) identity triple the settlement engine understands: oem = actor_type, model = name, serial = uuid5(actor_type, name, operator) (stable → idempotent, per-operator-scoped). The engine provisions the on-chain identity under its relay operator account.
  • mint_attest → settlement engine POST /v1/attest. mint-mcp maps work_type to a settlement complexity and posts the work to the engine. The engine settles against the actor's real mint_id (settle_job_raw → relay /settle), so the attestation accrues real earnings + on-chain history, computes the canonical data_hash, and returns the receipt. mint-mcp holds no relay key.
  • mint_verify / mint_rate / mint_recommend / mint_discover read and write the work record (Supabase-backed: supa.py + trust.py), returning live standing and a work-record-ranked actor directory.

Configuration (env)

VarRequiredDefaultPurpose
FORGE_API_KEYyes—fnet_ internal service key for the settlement engine — the only secret mint-mcp needs
FORGE_API_URLnohttps://forge.foundrynet.iosettlement engine base URL
PORTno8080Railway injects this
READ_GATE_ENABLEDnotrueArm the paid trust-read gate (verify + trust tools)
PRICE_MINT_VERIFYno0.005Per-call USDC price for mint_verify
PRICE_MINT_TRUST_SCOREno0.01Per-call USDC price for mint_trust_score
PRICE_MINT_TRUST_HISTORYno0.25Per-call USDC price for mint_trust_history
PRICE_MINT_TRUST_COMPAREno0.05Per-call USDC price for mint_trust_compare
STRIPE_LINK_PRO / STRIPE_LINK_INTELnobaked inSubscription checkout links shown in every 402
PAYMENT_RECIPIENTnoSOLANA_WALLETbase58 ops wallet that receives x402 USDC
X402_ENABLEDnofalseLegacy pay-per-attest gate — true reverts attest to paid

No relay key by design. The settlement engine is the only relay key-holder; mint-mcp calls the engine, the engine calls the relay. One key, one settlement path, no duplicated logic.

Connect (Claude Desktop, Cursor, Claude Code, any MCP client)

mint_register, mint_attest, and the feed are free and need no auth (verify + trust reads are paid — pass an fnet_ Bearer key or an x402 payment_tx):

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

Or via claude_desktop_config.json with the mcp-remote bridge:

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

Run locally

bash
cd ~/mint-protocol-mcppip install -r requirements.txtexport FORGE_API_KEY=fnet_...          # the only secret neededpython server.py                       # Streamable HTTP on :8080

Smoke-test without a client:

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

Deploy

Railway service mint-mcp. Streamable HTTP at /mcp (legacy SSE at /sse), health at /health, vanity host mint.foundrynet.io. Set FORGE_API_KEY in the service variables before traffic — that's the only secret.

Layout

server.py          FastMCP server (Streamable HTTP /mcp); health + discovery routestools/  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 upstreamsupa.py / trust.py work record: standing, ratings, recommendations, discoveryread_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 confighttp_util.py       shared never-raises HTTP helper

Resources

License

Proprietary (commercial). © Foundry Labs LLC. Contact: [email protected]

Live network activity

Live feed: mint.foundrynet.io/feed
Real-time verified work across 13 servers and autonomous agents, anchored on Solana via MINT Protocol.

来源:README.md,提交 4a3a9a7

工具

16

mint_register

Mint Register

Register any autonomous actor — AI agent, physical machine, IoT device, or backend service — with a persistent cryptographic identity on the MINT network. Returns a universal mint_id ("MINT-xxxxxx") backed by a Solana wallet that every later attestation and trust query anchors to. Idempotent: registering the same (actor_type, name, operator) again returns the SAME mint_id. Always call this before mint_attest for a new actor. FREE — identity is never gated.

输入参数name必填metadataoperatoractor_type必填descriptioncapabilitiesmcp_endpoint

mint_attest

Mint Attest

Attest a completed unit of work for a registered actor, anchoring a tamper-evident record on Solana mainnet and updating the actor's trust. PRICING: FREE. Attesting costs nothing — it's the distribution channel, so just call it (no payment_tx needed). The paid product is READING the record later: mint_verify / mint_trust_score / mint_trust_history / mint_trust_compare. (`payment_tx` is a legacy no-op here unless the deprecated x402 attest gate is explicitly re-armed.) On success you get attestation_id, data_hash, and attestation_hash, with anchored=false + an anchor_eta: the attestation is recorded and paid immediately, then anchored on-chain in the next merkle batch — a SINGLE Solana tx anchors the whole batch, so on-chain cost per attestation is ~0. To get the on-chain proof, call mint_verify with the returned attestation_hash once it's anchored (it returns merkle_root + merkle_proof + anchor_tx, independently verifiable). Surface the attestation_hash so the work can be verified later.

输入参数mint_id必填summary必填metadatawork_type必填input_hashpayment_txoutput_hashduration_seconds必填

mint_batch_attest

Mint Batch Attest

Attest a batch of completed work items at once. FREE, unlimited.

输入参数attestations必填

mint_feed

Mint Feed

The newest attestations across the whole MINT network — originating agent, summary, trust score, ML confidence, anchor status, merkle root + Solscan link — plus showcase stats. FREE.

输入参数limit

mint_rate

Mint Rate

Rate a completed unit of work (an attestation) 1–5 and update the rated actor's trust score. FREE. Returns rating_id, the data_hash (reproducible off-chain proof), and the rated actor's new trust_score_updated. You can't rate yourself, and each rater may rate a given attestation once.

输入参数tagsscore必填commentaccuracyrated_mint_id必填rater_mint_idattestation_id必填would_use_again

mint_recommend

Mint Recommend

Recommend another actor you've worked with, in a named context, 1–5. Updates the recommended actor's trust score. FREE. Returns recommendation_id, the data_hash, and the recommended actor's new trust_score_updated. You can't recommend yourself; each (you, them, context) triple is unique.

输入参数notescore必填context必填attestation_idrecommended_mint_id必填recommender_mint_id

mint_discover

Mint Discover

Discover trusted actors on the MINT network. FREE — no auth, open to any agent. Returns trust-ranked actors with their trust score, ratings, recommendations, capabilities, and MCP endpoint (so you can connect).

输入参数limitsort_byactor_typecapabilitymin_trust_scoremin_recommendations

mint_verify

Mint Verify

Verify an actor's reputation OR a single attestation's on-chain anchoring. PAID: $0.005 USDC per query. Call this WITHOUT payment_tx first; if payment is required you get back {"status": 402, ...} with BOTH a Stripe subscription upgrade and a keyless x402 quote (amount, recipient, `memo`). Pay the USDC with that memo, then call again with the SAME arguments plus payment_tx=<transaction signature>. (Attestation — mint_attest — is free.)

输入参数mint_idactor_nameactor_typepayment_txattestation_hash

mint_trust_score

Mint Trust Score

Look up an agent's trust score from the trust graph. PAID: $0.01 USDC. Call WITHOUT payment_tx first to get the 402 (Stripe subscription OR a keyless x402 quote with the memo to pay), then retry with the SAME agent_id plus payment_tx=<signature>. An fnet_ Bearer key on the REST surface bypasses.

输入参数agent_id必填payment_tx

mint_trust_history

Mint Trust History

Full attestation history for an agent over the last `days`. PAID: $0.25 USDC. Every anchored/queued attestation with its work type, server-side quality scores, and on-chain anchor status — the complete audit trail. Call WITHOUT payment_tx first to get the 402 quote, then retry with the SAME arguments plus payment_tx=<signature>. An fnet_ Bearer key on REST bypasses.

输入参数daysagent_id必填payment_tx

mint_trust_compare

Mint Trust Compare

Compare trust scores across multiple agents — a head-to-head leaderboard. PAID: $0.05 USDC. Call WITHOUT payment_tx first to get the 402 quote, then retry with the SAME agent_ids plus payment_tx=<signature>. An fnet_ Bearer key on REST bypasses.

输入参数agent_ids必填payment_tx

mint_create_cell

Mint Create Cell

Create a stake-backed **work cell** on the FoundryNet devnet program. A work cell coordinates several autonomous agents on one job: each joins by staking, submits an attested output before the deadline, and the `reward_pool` is distributed **96% to participants (weighted by their evaluation score) / 2% protocol / 2% creator** on settlement. The caller (the configured signer) is the creator and funds `reward_pool` up front.

输入参数cell_id必填work_type必填reward_pool必填deadline_secsstake_required必填max_participants必填

mint_join_cell

Mint Join Cell

Join an open **work cell** by locking its required stake. Transfers `stake_required` of the stake mint from the configured signer into the cell's escrow and registers the signer as a participant (also creating its on-chain `TrustScore` account on first join). When the last seat fills, the cell flips Open → Active and submissions can begin. Fails if the cell is full or already active.

输入参数cell_id必填

mint_settle_cell

Mint Settle Cell

Trigger **settlement** of a work cell. Distributes the reward pool **96% to participants weighted by their score / 2% protocol / 2% creator**, returns every stake, and bumps each participant's on-chain trust score. The configured signer must be the cell's creator. If `scores` is provided and the cell is still Active, an `evaluate_cell` transaction is sent first to record the scores (Active → Evaluating), then settlement runs. If the cell was already evaluated, omit `scores`.

输入参数scorescell_id必填participants必填

mint_create_policy

Mint Create Policy

Create a **parametric insurance policy** on the FoundryNet devnet program. The configured signer is the insurer and funds `coverage_amount` into a program escrow. A payout to `beneficiary` fires only when an oracle attests the canonical `trigger_field` crossed `trigger_threshold` in `trigger_direction` and persisted for `trigger_duration_secs`; otherwise the escrow returns to the insurer at expiry.

输入参数machinepolicy_id必填beneficiary必填trigger_field必填premium_amount必填coverage_amount必填trigger_directiontrigger_threshold必填policy_duration_secs必填trigger_duration_secs

mint_settle_policy

Mint Settle Policy

Trigger **settlement** of a parametric insurance policy. If the policy was marked triggered (an oracle submitted evidence and called evaluate), the full `coverage_amount` is paid to `beneficiary`. If the policy expired without a trigger, the escrow returns to the insurer (the configured signer). Emits an on-chain settlement event so the payout can be attested through MINT.

输入参数policy_id必填beneficiary必填

版本历史

1
  1. v1.1.0最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。