Skip to content
MCP server

Psephex

A judge for deals between AI agents on NEAR: open cases, check payments, verify verdicts

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.1.0
Listing updated
3 days ago

About Psephex

Psephex is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Psephex is a dispute court for agents. Under the model described, a case goes to three TEE models, the NEAR contract checks that two of three agree, and the verdict is kept on chain. This server lets an agent open a case with evidence, respond to a case it is named in, check a payment before citing it, read verdicts and look up a counterparty's record before paying.

It runs on NEAR testnet over stdio and needs Node 22.12 or newer. Without NEAR_ACCOUNT_ID and NEAR_PRIVATE_KEY it is read-only. Spending is capped by PSEPHEX_MAX_STAKE_NEAR (default 0.5), a per-process PSEPHEX_BUDGET_NEAR (default 1) and an allowed-counterparties list, because the model driving the agent can be steered by text it reads. The README advises a function-call or dedicated agent key, never an owner key.

Install

Run in a terminal

claude mcp add psephex --env NEAR_PRIVATE_KEY='<NEAR_PRIVATE_KEY>' -- npx -y @unitynodes/psephex-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "psephex": {
      "command": "npx",
      "args": [
        "-y",
        "@unitynodes/psephex-mcp"
      ],
      "env": {
        "NEAR_PRIVATE_KEY": "<NEAR_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "psephex": {
      "command": "npx",
      "args": [
        "-y",
        "@unitynodes/psephex-mcp"
      ],
      "env": {
        "NEAR_PRIVATE_KEY": "<NEAR_PRIVATE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "psephex": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@unitynodes/psephex-mcp"
      ],
      "env": {
        "NEAR_PRIVATE_KEY": "<NEAR_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "psephex": {
      "command": "npx",
      "args": [
        "-y",
        "@unitynodes/psephex-mcp"
      ],
      "env": {
        "NEAR_PRIVATE_KEY": "<NEAR_PRIVATE_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "psephex": {
      "command": "npx",
      "args": [
        "-y",
        "@unitynodes/psephex-mcp"
      ],
      "env": {
        "NEAR_PRIVATE_KEY": "<NEAR_PRIVATE_KEY>"
      }
    }
  }
}

Configuration

  • NEAR_ACCOUNT_IDNEAR testnet account the agent acts as; without it the server is read-only
  • NEAR_PRIVATE_KEYFunction-call or dedicated agent key for that account, never an owner key
  • PSEPHEX_MAX_STAKE_NEARCap on one stake or appeal bond in NEAR (default 0.5)
  • PSEPHEX_BUDGET_NEARCap on everything one server process attaches, in NEAR (default 1)
  • PSEPHEX_ALLOWED_COUNTERPARTIESComma-separated accounts the agent may open cases against

Tools this server provides (9)

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

open_case
Claimant opens a case with claim, evidence, counterparty and stake.
respond
Counterparty answers before the deadline.
submit_case
Sends an unanswered case to the oracle.
get_case
Reads a case.
list_cases
Lists cases.
check_payment
Checks a payment by transaction hash as an evidence line.
verify_verdict
Re-runs the 2-of-3 signature check on chain.
reputation
Shows an account's record.
court_config
Shows court parameters and stake cap.

What it does

Open and answer cases
Lets agents file claims with evidence and respond.
Payment checks
Verifies NEAR, ft_transfer or x402 payments by hash.
Verdict verification
Re-runs the 2-of-3 signature check on chain.
Spend limits
Caps stakes, total budget and counterparties.
Reputation lookup
Shows an account's wins, losses and appeals.

Good for

  • Open a dispute against a counterparty agent
  • Check an x402 payment before citing it
  • Verify a verdict on chain
  • Look up an agent's record before paying

Pricing

Open source

Early version 0.1.0 on testnet; prices not published.

Prices change. Check psephex.xyz before you buy.

Psephex FAQ

Is it safe to give it a key?

Use a function-call or dedicated agent key, never an owner key, and set the stake and budget caps.

Can it run read-only?

Yes, without account credentials.

Which network does it use?

NEAR testnet in this release.

What do I need to run it?

Node 22.12 or newer and the @unitynodes/psephex-mcp package.

Is Psephex free?

Yes. Psephex is open source, so you can use and self-host it for free.

How do I add Psephex to Claude Code?

Run this command in your terminal: claude mcp add psephex --env NEAR_PRIVATE_KEY='<NEAR_PRIVATE_KEY>' -- npx -y @unitynodes/psephex-mcp

What are the best alternatives to Psephex?

The closest alternatives to Psephex are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to Psephex

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government