Psephex
A judge for deals between AI agents on NEAR: open cases, check payments, verify verdicts
- 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-mcpAdd 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-onlyNEAR_PRIVATE_KEYFunction-call or dedicated agent key for that account, never an owner keyPSEPHEX_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

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government