Skip to content
MCP server

MCP Server

MCP server for verifiable randomness, provably fair games and signed receipts via FairSeal

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.2.4
Listing updated
1 day ago

About MCP Server

MCP Server is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

FairSeal's pitch is a neutral third party between systems that do not trust each other. A rule and its inputs are locked into a hash before the outcome is observable, a public drand beacon supplies randomness neither side controls, the result is derived deterministically, and anyone can re-run each step. Receipts are signed and can be anchored on Base.

The server exposes gated tools that need an fsn_ API key, including entropy, stats, random generation, decision notarization and anchor submission. Game reads, notarize status and anchor status work without a key. The registry entry also describes an x402 micropayment of 0.02 USDC on Base as an alternative to a key for notarize and anchor calls.

The site is candid about limits: a valid receipt proves provenance, not that an agent's decision or a game outcome was correct. The wider project is aimed at game studios, with slots, gacha and loot-box examples, as well as agent-to-agent accountability.

Install

Run in a terminal

claude mcp add mcp-server --env FAIRSEAL_API_KEY='<FAIRSEAL_API_KEY>' --env FAIRSEAL_NOTARY_API_KEY='<FAIRSEAL_NOTARY_API_KEY>' --env FAIRSEAL_ANCHOR_API_KEY='<FAIRSEAL_ANCHOR_API_KEY>' -- npx -y @fairseal/mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fairseal/mcp-server"
      ],
      "env": {
        "FAIRSEAL_API_KEY": "<FAIRSEAL_API_KEY>",
        "FAIRSEAL_NOTARY_API_KEY": "<FAIRSEAL_NOTARY_API_KEY>",
        "FAIRSEAL_ANCHOR_API_KEY": "<FAIRSEAL_ANCHOR_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fairseal/mcp-server"
      ],
      "env": {
        "FAIRSEAL_API_KEY": "<FAIRSEAL_API_KEY>",
        "FAIRSEAL_NOTARY_API_KEY": "<FAIRSEAL_NOTARY_API_KEY>",
        "FAIRSEAL_ANCHOR_API_KEY": "<FAIRSEAL_ANCHOR_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@fairseal/mcp-server"
      ],
      "env": {
        "FAIRSEAL_API_KEY": "<FAIRSEAL_API_KEY>",
        "FAIRSEAL_NOTARY_API_KEY": "<FAIRSEAL_NOTARY_API_KEY>",
        "FAIRSEAL_ANCHOR_API_KEY": "<FAIRSEAL_ANCHOR_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fairseal/mcp-server"
      ],
      "env": {
        "FAIRSEAL_API_KEY": "<FAIRSEAL_API_KEY>",
        "FAIRSEAL_NOTARY_API_KEY": "<FAIRSEAL_NOTARY_API_KEY>",
        "FAIRSEAL_ANCHOR_API_KEY": "<FAIRSEAL_ANCHOR_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fairseal/mcp-server"
      ],
      "env": {
        "FAIRSEAL_API_KEY": "<FAIRSEAL_API_KEY>",
        "FAIRSEAL_NOTARY_API_KEY": "<FAIRSEAL_NOTARY_API_KEY>",
        "FAIRSEAL_ANCHOR_API_KEY": "<FAIRSEAL_ANCHOR_API_KEY>"
      }
    }
  }
}

Configuration

  • FAIRSEAL_API_KEYAPI key for gated tools (fairseal_entropy, fairseal_stats, fairseal_rng_generate, fairseal_notarize_decision, fairseal_anchor_submit). Key prefix: fsn_. Without a key these tools return 401; free tools (game reads, notarize_status, anchor_status) work without any key. x402 micropayment ($0.02 USDC on Base) is an alternative to the key for notarize/anchor.
  • FAIRSEAL_API_URLUpstream API base URL (default https://api.fairseal.io).
  • FAIRSEAL_NOTARY_API_KEYKey override for the notary service only (POST /v1/notarize). Falls back to FAIRSEAL_API_KEY if not set. Key prefix: fsn_.
  • FAIRSEAL_ANCHOR_API_KEYKey override for Anchor API v2 only (POST /v2/anchor). Falls back to FAIRSEAL_API_KEY if not set. Key prefix: anck_.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

fairseal_entropy
Verifiable entropy; needs an API key.
fairseal_stats
Stats; needs an API key.
fairseal_rng_generate
Random generation; needs an API key.
fairseal_notarize_decision
Notarizes a decision; needs a key or x402 payment.
fairseal_anchor_submit
Submits an anchor; needs a key or x402 payment.
notarize_status
Checks notarization status; free.
anchor_status
Checks anchor status; free.

What it does

Committed randomness
Locks rules before a public beacon round is known.
Signed receipts
Issues EIP-191 or Ed25519 signed receipts.
Decision notarization
Notarizes an agent decision for later verification.
On-chain anchoring
Publishes batch seals on Base.
Independent verification
Receipts can be checked at a public verifier.
Pay-per-call option
Supports x402 payments instead of an API key.

Good for

  • Prove an agent's decision was recorded before its outcome
  • Generate verifiable random selections for allocations
  • Audit loot-drop or matchmaking fairness
  • Verify a receipt from another system

Pricing

Freemium

Free read tools; gated tools need a key or $0.02 USDC per call

Prices change. Check fairseal.io before you buy.

MCP Server FAQ

Do I need an API key?

For gated tools yes (prefix fsn_), though game reads and status checks work without one.

Can I pay without a key?

The registry says an x402 micropayment of $0.02 USDC on Base is an alternative for notarize and anchor.

Does a receipt prove the decision was right?

No. The site says receipts prove provenance, not correctness.

Where does the randomness come from?

From a public drand beacon.

Is MCP Server free?

MCP Server has a free plan, with paid plans for more usage or features.

How do I add MCP Server to Claude Code?

Run this command in your terminal: claude mcp add mcp-server --env FAIRSEAL_API_KEY='<FAIRSEAL_API_KEY>' --env FAIRSEAL_NOTARY_API_KEY='<FAIRSEAL_NOTARY_API_KEY>' --env FAIRSEAL_ANCHOR_API_KEY='<FAIRSEAL_ANCHOR_API_KEY>' -- npx -y @fairseal/mcp-server

What are the best alternatives to MCP Server?

The closest alternatives to MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to MCP Server

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools