English Français العربية

io.github.ned-del/fairseal-mcp-server

السجل الرسمي الألعاب والرياضة والترفيه

Verifiable entropy, provably-fair games, and receipt verification for AI agents (FairSeal API).

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @fairseal/mcp-server
Claude Code 
claude mcp add fairseal-mcp-server -e 'FAIRSEAL_API_KEY=<your fairseal_api_key>' -e 'FAIRSEAL_API_URL=<FAIRSEAL_API_URL>' -- npx -y @fairseal/mcp-server@0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "fairseal-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@fairseal/mcp-server@0.1.3"
            ],
            "env": {
                "FAIRSEAL_API_KEY": "<your fairseal_api_key>",
                "FAIRSEAL_API_URL": "<FAIRSEAL_API_URL>"
            }
        }
    }
}

متغيرات البيئة

  • FAIRSEAL_API_KEY سري Optional API key sent as Bearer header (live API currently requires no auth; any placeholder works).
  • FAIRSEAL_API_URL Upstream API base URL (default https://api.fairseal.io).

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Fairseal 🦭
  2. Try It Now
  3. Quick Start
  4. How It Works
  5. Performance
  6. Packages
  7. Use Cases
  8. Result Notarization vs. Activity Receipts
  9. Links
  10. Listings
  11. License

Fairseal 🦭

Provably fair selections for games, loot boxes, and any randomized allocation.

Fairseal creates verifiable receipts (CSRs) proving that a selection was committed before the outcome was knowable. Every loot drop, gacha pull, and randomized selection — independently verifiable, trustlessly.

Try It Now

npx @fairseal/commit

One command. A verifiable gacha pull in your terminal. No setup.

Quick Start

npm install @fairseal/commit
import { createCommitment, resolveCommitment, createReceipt, verifyReceipt } from '@fairseal/commit';

// 1. Lock your loot table BEFORE the outcome is knowable
const commitment = createCommitment({
  rule: JSON.stringify(LOOT_TABLE),
  inputs: [playerId, pullNumber.toString()],
  revealAfter: 10,
});

// 2. Resolve with verifiable entropy from drand
const resolution = await resolveCommitment(commitment);

// 3. Your algorithm + verifiable entropy = provably fair drop
const drop = yourWeightedPull(LOOT_TABLE, resolution.beaconRandomness);

// 4. Package as a receipt anyone can verify
const receipt = createReceipt(commitment, resolution);
const proof = await verifyReceipt(receipt); // ✅ PARTIAL

How It Works

  1. Commit — Lock your drop table + player ID into a hash before the randomness exists
  2. Entropy — Wait for a public drand beacon round (Cloudflare + Protocol Labs)
  3. Resolve — Derive the selection from beacon entropy + your committed rule
  4. Verify — Anyone can re-run every step. drand beacon signatures are BLS12-381-verified; FairSeal receipt signatures use EIP-191 (secp256k1) / Ed25519 — receipts are never BLS-signed. No trust required.

Performance

OperationTime
Commitment creation0.006ms (170,000+/sec)
Beacon fetch~200ms
drand beacon verification (BLS12-381)~150ms
Receipt size0.9 KB

Client-side. No server. No account. No fees for PARTIAL verification.

Packages

PackageDescription
@fairseal/gameGame API for RGS studios. Slots, gacha, loot boxes. (v0.1 ALPHA)
@fairseal/commitCommitted selection receipts. Core library.
@fairseal/coreCryptographic primitives, signing, Merkle trees.
@fairseal/verifyIndependent receipt verification.
@fairseal/mcp-serverMCP server for AI agents. Verifiable entropy, provably-fair games, cryptographic receipt verification via Model Context Protocol.

Use Cases

ScenarioHow
Gacha / loot boxEvery pull has a receipt. Players verify drops match published rates.
Boss loot dropsDrop table committed per encounter. No ninja-nerfing.
MatchmakingPairing algorithm committed. Players verify no favoritism.
Tournament bracketsSeeding provably random, not rigged.
NFT mint orderQueue provably fair — no insider front-running.
Slot machinesSeed Commitment Model — verifiable spins, no nonce chain.

Result Notarization vs. Activity Receipts

Most "agent receipts" today are activity receipts: the platform logs what an agent did, and you trust whoever wrote the log. Fairseal receipts are result notarization — a different trust model:

Activity receipts (platform logs)Fairseal result notarization
Who do you trust?The operator writing the logNo one — receipts verify offline
What is proven?That an action was recordedThat a result was committed before the outcome was knowable
Time proofServer timestamp (operator-controlled)External anchor on Base (independently checkable)
Tamper evidenceDepends on log integrityHash-anchored; any modification breaks verification

Related standards: payment-authorization protocols like Google/Mastercard AP2 (mandates), Visa TAP, and OpenAI/Stripe ACP prove that an agent may act and who it is. Fairseal proves what happened — that a result was committed and hasn't been altered since. Fairseal settles micropayments over Coinbase's x402 and does not implement AP2/TAP/ACP; the layers are complementary.

Listings

License

MIT — Fairseal

الأسئلة الشائعة

ما هو io.github.ned-del/fairseal-mcp-server؟

Verifiable entropy, provably-fair games, and receipt verification for AI agents (FairSeal API).

كيف أثبّت io.github.ned-del/fairseal-mcp-server؟

يعمل على جهازك. في Claude Code: claude mcp add fairseal-mcp-server -e 'FAIRSEAL_API_KEY=<your fairseal_api_key>' -e 'FAIRSEAL_API_URL=<FAIRSEAL_API_URL>' -- npx -y @fairseal/mcp-server@0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ned-del/fairseal-mcp-server إلى مفتاح API؟

نعم. يتطلب FAIRSEAL_API_KEY، وتضبطها في إعداداته.

هل io.github.ned-del/fairseal-mcp-server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.ned-del/fairseal-mcp-server؟

ينشره fairseal-io. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.