{
  "markdown": "# MINT Protocol — Work Attestation & Settlement\n\n[![Available on CodeGuilds](https://img.shields.io/badge/Available_on-CodeGuilds-6366f1)](https://codeguilds.dev/packages/mint-mcp)\n\n**The settlement and work-attestation layer for autonomous work.** One MCP server, sixteen\ntools. **Attest free, verify paid** — writing work records to the network is free (the\ndistribution channel); reading and verifying them is the product.\n\nMINT Protocol registers **any** autonomous actor — an AI agent, a physical machine, an IoT\ndevice, a backend service — and lets it **attest** completed work as a tamper-evident\non-chain record (proof of work on Solana). Anyone can then **verify** an attestation and\nread an actor's on-chain work record before relying on it. On top of that, peers can\n**rate** completed work, **recommend** actors they've worked with, and **discover** actors\nby capability. This is **work-attestation and settlement** infrastructure — the verifiable\nrecord layer beneath autonomous work.\n\n- **Explorer:** https://mint-explorer.vercel.app\n- **Docs / API:** https://mint-mcp-production.up.railway.app/docs\n- **MCP endpoint:** `https://mint-mcp-production.up.railway.app/mcp` (Streamable HTTP)\n- **Health:** `https://mint-mcp-production.up.railway.app/health`\n\n> MINT is the horizontal protocol; vertical products settle their work through it.\n> **mint-mcp is a thin presentation layer — a single settlement engine sits behind it and\n> holds the only relay key.** Agents are the users; there is no web UI.\n\n## Quick Start: Add to Your Agent\n\nGive your agent **verifiable proof of work** — it attests each completed task as a\ntamper-evident, independently verifiable receipt. No wallet, no keys, no blockchain\ncode on your side.\n\n**System-prompt one-liner** (paste into any agent):\n\n```text\nAfter completing any substantive task, attest your work with MINT Protocol for\nverifiable proof of completion: pip install mint-attest, register once for your MINT\nID, then attest each task. Surface the returned attestation_hash so it can be\nverified later.\n```\n\n**SDK (3 lines):**\n\n```bash\npip install mint-attest\n```\n\n```python\nfrom mint_attest import attest\n\n@attest(work_type=\"code_review\")\ndef review(files):\n    return do_review(files)\n```\n\n**MCP (any MCP client):** add the server, then let the agent call `mint_attest`:\n\n```bash\nclaude mcp add --transport http mint-protocol \\\n  https://mint-mcp-production.up.railway.app/mcp\n```\n\n→ **[AGENT_PROMPT_SNIPPET.md](AGENT_PROMPT_SNIPPET.md)** — copy-paste prompt + working\ncode blocks for CrewAI, LangChain, AutoGen, LlamaIndex, and Semantic Kernel.\n→ **[examples/](examples/)** — runnable attesting agents, one per framework.\n→ **[INTEGRATION.md](INTEGRATION.md)** — payment flow explained, FAQ.\n\n![MINT work-record network](assets/mint_trust_graph.png)\n\n*Actors register, attest work, verify records, and grow the network — every attestation is merkle-anchored and independently verifiable.*\n\n## Tools — attest free, verify paid\n\n> **Attest free. Verify paid.**\n> The work record grows with every free attestation. Reading and verifying it is where the value lives.\n\n**Free — write work records + discovery** (every free attestation is a distribution point):\n\n| Tool | What it does | Price |\n|------|--------------|-------|\n| `mint_register`     | Register any autonomous actor with a persistent cryptographic identity + Solana wallet. Idempotent. | **Free** |\n| `mint_attest`       | Anchor a completed unit of work on Solana — tamper-evident record. | **Free, unlimited** |\n| `mint_batch_attest` | Anchor many work items in one call. | **Free** |\n| `mint_feed`         | Live network attestation feed (the public showcase). | **Free** |\n| `mint_rate`         | Rate a completed attestation 1–5; recorded against the actor's work record. | **Free** |\n| `mint_recommend`    | Endorse an actor you've worked with in a named context. | **Free** |\n| `mint_discover`     | Search the registered-actor directory by capability, ranked by work record. | **Free** |\n\n**Paid — read + verify the work record** (the product; x402 USDC per call **or** an `fnet_` subscription key):\n\n| Tool | What it does | Price |\n|------|--------------|-------|\n| `mint_verify`        | Verify an attestation or an actor's on-chain work record against the chain. | **$0.005** |\n| `mint_trust_score`   | Standing for a registered actor, computed from its attested + settled work record. | **$0.01** |\n| `mint_trust_history` | Full attestation audit trail for a registered actor. | **$0.25** |\n| `mint_trust_compare` | Rank registered actors by their attested work record. | **$0.05** |\n\nStanding is computed from verified on-chain work history, ratings, and peer endorsements —\nabsence of data reads as neutral (50), not zero.\n\n**Devnet — FoundryNet on-chain (5, experimental)** — stake-backed work cells and parametric\ninsurance built against the devnet `foundry_net` program. Live MCP tools, no per-call fee\n(Solana network fee only):\n\n| Tool | What it does |\n|------|--------------|\n| `mint_create_cell`   | Open a stake-backed on-chain work cell. |\n| `mint_join_cell`     | Join a work cell by staking; opens participant + trust accounts. |\n| `mint_settle_cell`   | Evaluate + settle a work cell; 96/2/2 split, stakes returned, trust updated. |\n| `mint_create_policy` | Open a parametric insurance policy with funded coverage escrow. |\n| `mint_settle_policy` | Settle a policy: pay beneficiary if triggered, else refund insurer. |\n\n## Economic model — attest free, verify paid (the 2026-06-30 pivot)\n\nMINT flipped its pricing: **attestation is the distribution channel, not the product.**\n\n- **Writing is free.** Every actor that attests becomes a distribution point for MINT,\n  and every free attestation grows the on-chain work record. Registration, attestation\n  (single + batch), the live feed, ratings, recommendations, and discovery are all free,\n  unlimited.\n- **Reading is the product.** Verifying an attestation or reading an actor's work record\n  against the chain is paid — keyless **x402 USDC micro-payments** per call (verify $0.005 →\n  trust_history $0.25) **or** a Stripe subscription (**Pro $19/mo**, **Intelligence\n  $49/mo**) whose `fnet_` key bypasses per-call payment. Revenue is collected in USDC /\n  Stripe with **no token dependency**.\n- **MINT Token Utility (roadmap, not active):** the token exists on Solana but\n  minting/distribution are dormant; staking-for-discoverability and trust-weighted\n  governance activate only once the network reaches meaningful volume.\n\nFull detail is in **[TOKENOMICS.md](TOKENOMICS.md)**. To revert to the legacy\npay-per-attest model, set `X402_ENABLED=true` (and `READ_GATE_ENABLED=false`).\n\n## How settlement works (one key-holder, one relay path)\n\n- **`mint_register` → settlement engine `POST /v1/identify`.** An actor is mapped onto the\n  `(oem, model, serial)` identity triple the settlement engine understands:\n  `oem = actor_type`, `model = name`, `serial = uuid5(actor_type, name, operator)`\n  (stable → idempotent, per-operator-scoped). The engine provisions the on-chain identity\n  under its relay operator account.\n- **`mint_attest` → settlement engine `POST /v1/attest`.** mint-mcp maps `work_type` to a\n  settlement `complexity` and posts the work to the engine. The engine settles against the\n  actor's **real** `mint_id` (`settle_job_raw` → relay `/settle`), so the attestation\n  accrues real earnings + on-chain history, computes the canonical `data_hash`, and returns\n  the receipt. mint-mcp holds no relay key.\n- **`mint_verify` / `mint_rate` / `mint_recommend` / `mint_discover`** read and write the\n  work record (Supabase-backed: `supa.py` + `trust.py`), returning live standing and a\n  work-record-ranked actor directory.\n\n## Configuration (env)\n\n| Var | Required | Default | Purpose |\n|-----|----------|---------|---------|\n| `FORGE_API_KEY` | yes | — | `fnet_` internal service key for the settlement engine — the only secret mint-mcp needs |\n| `FORGE_API_URL` | no | `https://forge.foundrynet.io` | settlement engine base URL |\n| `PORT` | no | `8080` | Railway injects this |\n| `READ_GATE_ENABLED` | no | `true` | Arm the paid trust-read gate (verify + trust tools) |\n| `PRICE_MINT_VERIFY` | no | `0.005` | Per-call USDC price for `mint_verify` |\n| `PRICE_MINT_TRUST_SCORE` | no | `0.01` | Per-call USDC price for `mint_trust_score` |\n| `PRICE_MINT_TRUST_HISTORY` | no | `0.25` | Per-call USDC price for `mint_trust_history` |\n| `PRICE_MINT_TRUST_COMPARE` | no | `0.05` | Per-call USDC price for `mint_trust_compare` |\n| `STRIPE_LINK_PRO` / `STRIPE_LINK_INTEL` | no | baked in | Subscription checkout links shown in every 402 |\n| `PAYMENT_RECIPIENT` | no | `SOLANA_WALLET` | base58 ops wallet that receives x402 USDC |\n| `X402_ENABLED` | no | `false` | **Legacy** pay-per-attest gate — `true` reverts attest to paid |\n\n> **No relay key by design.** The settlement engine is the only relay key-holder; mint-mcp\n> calls the engine, the engine calls the relay. One key, one settlement path, no duplicated\n> logic.\n\n## Connect (Claude Desktop, Cursor, Claude Code, any MCP client)\n\n`mint_register`, `mint_attest`, and the feed are free and need no auth (verify + trust\nreads are paid — pass an `fnet_` Bearer key or an x402 `payment_tx`):\n\n```bash\nclaude mcp add --transport http mint-protocol \\\n  https://mint-mcp-production.up.railway.app/mcp\n```\n\nOr via `claude_desktop_config.json` with the `mcp-remote` bridge:\n\n```json\n{\n  \"mcpServers\": {\n    \"mint-protocol\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\",\n               \"https://mint-mcp-production.up.railway.app/mcp\"]\n    }\n  }\n}\n```\n\n## Run locally\n\n```bash\ncd ~/mint-protocol-mcp\npip install -r requirements.txt\nexport FORGE_API_KEY=fnet_...          # the only secret needed\npython server.py                       # Streamable HTTP on :8080\n```\n\nSmoke-test without a client:\n\n```bash\ncurl -s localhost:8080/health | jq\ncurl -s localhost:8080/.well-known/agent-card.json | jq\n```\n\n## Deploy\n\nRailway service **`mint-mcp`**. Streamable HTTP at `/mcp` (legacy SSE at `/sse`), health at\n`/health`, vanity host `mint.foundrynet.io`. Set **`FORGE_API_KEY`** in the service\nvariables before traffic — that's the only secret.\n\n## Layout\n\n```\nserver.py          FastMCP server (Streamable HTTP /mcp); health + discovery routes\ntools/\n  register.py      mint_register        (free)\n  attest.py        mint_attest          (free)\n  batch_attest.py  mint_batch_attest    (free)\n  feed.py          mint_feed            (free)\n  rate.py          mint_rate            (free)\n  recommend.py     mint_recommend       (free)\n  discover.py      mint_discover        (free)\n  verify.py        mint_verify          ($0.005 — read_gate)\n  trust_score.py   mint_trust_score     ($0.01  — read_gate)\n  trust_history.py mint_trust_history   ($0.25  — read_gate)\n  trust_compare.py mint_trust_compare   ($0.05  — read_gate)\nforge_client.py    settlement-engine client (identify + attest) — the only upstream\nsupa.py / trust.py work record: standing, ratings, recommendations, discovery\nread_gate.py       paid trust-read gate (Stripe-first 402 + keyless x402; fnet_ bypass)\npayment_gate.py    legacy pay-per-attest gate (INERT unless X402_ENABLED)\nconfig.py          env-driven config\nhttp_util.py       shared never-raises HTTP helper\n```\n\n## Resources\n\n- [Work Attestation for Autonomous Actors](https://foundrynet.io/work-attestation?utm_source=github&utm_medium=readme&utm_campaign=mint-mcp)\n- [Tokenomics — the two-layer economic model](TOKENOMICS.md)\n- [API Documentation](https://mint-mcp-production.up.railway.app/docs)\n- [Explorer](https://mint-explorer.vercel.app)\n\n## License\n\nProprietary (commercial). © Foundry Labs LLC. Contact: forge@foundrynet.io\n\n## Live network activity\n\n**Live feed:** [mint.foundrynet.io/feed](https://mint.foundrynet.io/feed)  \nReal-time verified work across 13 servers and autonomous agents, anchored on Solana via [MINT Protocol](https://mint.foundrynet.io).\n",
  "bytes": 11958,
  "sha": "94791ae0cc54937141175db66a50d15af851338d4536926182e4d5f65320b23f",
  "repo_slug": "foundrynet/mint-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_foundrynet_mint_mcp_31ab4a26/readme"
}