Ermöglicht es AI Agents, an einem NEAR Testnet-Gericht teilzunehmen, indem sie Fälle eröffnen, auf Streitigkeiten reagieren, Zahlungen verifizieren und Reputations prüfen.
Auch bekannt als UnityNodes/psephex, @unitynodes/psephex-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.0
- Letzter Commit
- 13. Nov. 2026
- Lizenz
- MIT
Was ist Psephex MCP?
Psephex ist ein MCP server. Ermöglicht es AI Agents, an einem NEAR Testnet-Gericht teilzunehmen, indem sie Fälle eröffnen, auf Streitigkeiten reagieren, Zahlungen verifizieren und Reputations prüfen.
Zusammenfassung generiert aus dem README des Projekts
Über Psephex MCP server
Psephex bietet AI Agents eine Möglichkeit, mit einem dezentralen Gerichtssystem auf dem NEAR Testnet zu interagieren. Entwickler, die MCP-Clients wie Claude Desktop oder Claude Code nutzen, können ihre Agents mit diesem Server verbinden, um rechtlich anmutende Streitigkeiten zu verwalten. Der Server erlaubt es Agents, neue Fälle inklusive Beweisen zu eröffnen, auf bestehende Streitigkeiten zu reagieren und unbeantwortete Fälle an ein Oracle zu übergeben. Er enthält zudem Tools, um Urteile on-chain zu verifizieren und die Reputation anderer Accounts basierend auf deren Historie aus Siegen, Niederlagen und Appeals zu prüfen.
Um eine aktive Teilnahme zu ermöglichen, benötigt der Server eine NEAR Account ID und einen Private Key über Umgebungsvariablen. Ohne diese Zugangsdaten arbeitet der Server im Read-only-Modus. Die Sicherheit wird durch spezifische Constraints verwaltet, wie etwa PSEPHEX_MAX_STAKE_NEAR zur Deckelung einzelner Bonds, PSEPHEX_BUDGET_NEAR zur Begrenzung der Gesamtausgaben pro Prozess und PSEPHEX_ALLOWED_COUNTERPARTIES, um einzuschränken, mit welchen Accounts ein Agent interagieren darf. Das System unterstützt die Verifizierung von Zahlungen mittels NEAR Transfers, ft_transfer oder x402 signed-delegate Payments unter Verwendung von vertrauenswürdigen Token wie Circle testnet USDC.
Was du damit machen kannst
- 1Einen formellen Streitfall einleitenEin Agent kann ein rechtliches Verfahren starten, indem er einen Anspruch, Beweise und einen Stake bereitstellt.
- 2Finanzielle Abwicklungen verifizierenEin Agent kann bestätigen, dass ein spezifischer Transaction Hash eine gültige Zahlung darstellt, bevor er diesen als Beweis nutzt.
- 3Zuverlässigkeit von Agents bewertenEin Entwickler kann einen Agent anweisen, die Gewinn- und Verluststatistik eines anderen Accounts abzufragen, bevor er eine Transaktion durchführt.
- 4Gerichtliche Entscheidungen validierenEin Agent kann einen Signature Check auf dem Oracle Contract durchführen, um sicherzustellen, dass ein Urteil legitim ist.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Psephex MCP
Formate geprüft am 10. Nov. 2026Psephex MCP in Claude Code installieren
$ claude mcp add --env NEAR_PRIVATE_KEY=<YOUR_NEAR_PRIVATE_KEY> psephex -- npx -y @unitynodes/psephex-mcpPsephex MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Psephex MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"psephex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Psephex MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Psephex MCP in Codex installieren
~/.codex/config.toml
[mcp_servers.psephex] command = "npx" args = ["-y", "@unitynodes/psephex-mcp"] [mcp_servers.psephex.env] NEAR_PRIVATE_KEY = "<YOUR_NEAR_PRIVATE_KEY>"
Psephex MCP in Gemini CLI installieren
~/.gemini/settings.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Konfiguration
NEAR_PRIVATE_KEYSecretFunction-call or dedicated agent key for that account, never an owner key
NEAR_ACCOUNT_IDNEAR testnet account the agent acts as; without it the server is read-only
PSEPHEX_ALLOWED_COUNTERPARTIESComma-separated accounts the agent may open cases against
PSEPHEX_BUDGET_NEARCap on everything one server process attaches, in NEAR (default 1)
PSEPHEX_MAX_STAKE_NEARCap on one stake or appeal bond in NEAR (default 0.5)
| Name | Beschreibung | Typ |
|---|---|---|
| NEAR_PRIVATE_KEY | Function-call or dedicated agent key for that account, never an owner key | Secret |
| NEAR_ACCOUNT_ID | NEAR testnet account the agent acts as; without it the server is read-only | |
| PSEPHEX_ALLOWED_COUNTERPARTIES | Comma-separated accounts the agent may open cases against | |
| PSEPHEX_BUDGET_NEAR | Cap on everything one server process attaches, in NEAR (default 1) | |
| PSEPHEX_MAX_STAKE_NEAR | Cap on one stake or appeal bond in NEAR (default 0.5) |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarunitynodes/psephex is public and reachablegithub.com/unitynodes/psephex ↗Bestanden
- Paket nennt dieses Repository als Quelle@unitynodes/psephex-mcp names unitynodes/psephex as sourcenpmjs.com/package/@unitynodes/psephex-mcp ↗Bestanden
- Build-Herkunft (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-13github.com/unitynodes/psephex ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @unitynodes/psephex-mcpBestanden
- Kein kritischer Hinweis im Paket oder seinen Abhängigkeitenthe package checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenpsephex-mcp
MCP server that lets an AI agent use the Psephex court on NEAR testnet: open a case with its evidence, answer a case it is named in, check a NEAR or x402 payment before citing it, read verdicts and re-check them on chain, and look up another agent's record before paying it.
Claude Code, Claude Desktop or any MCP client (stdio), with Node 22.12 or newer:
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": ["-y", "@unitynodes/psephex-mcp"],
"env": { "NEAR_ACCOUNT_ID": "my-agent.testnet", "NEAR_PRIVATE_KEY": "ed25519:...", "PSEPHEX_MAX_STAKE_NEAR": "0.2" }
}
}
}
Claude Code in one line: claude mcp add psephex -- npx -y @unitynodes/psephex-mcp. From a checkout instead: npm ci && npm run build, then node dist/src/main.js.
Without NEAR_ACCOUNT_ID and NEAR_PRIVATE_KEY the server is read-only. Spending is bounded three ways, because the model driving the agent can be steered by text it reads (the other party's case, API data): PSEPHEX_MAX_STAKE_NEAR caps one stake or appeal bond (default 0.5), PSEPHEX_BUDGET_NEAR caps everything one server process attaches (default 1), and PSEPHEX_ALLOWED_COUNTERPARTIES (comma-separated) pins who the agent may open cases against. check_payment only counts tokens on PSEPHEX_TRUSTED_TOKENS (default: Circle testnet USDC and wrap.testnet) and only when every receipt succeeded. .npmrc sets legacy-peer-deps as in relayer/ and web/: npm 10.9 fails on the vitest peer set otherwise. Use a function-call or dedicated agent key, never an owner key.
| Tool | What it does |
|---|---|
whoami, court_config |
the acting account, its stake cap, court parameters |
open_case |
claimant opens a case: claim, evidence, counterparty, stake |
respond |
counterparty answers before the deadline (sends the case to the oracle) |
submit_case |
anyone sends an unanswered case to the oracle after the deadline |
appeal, finalize, refund |
appeal with the case's bond, pay out after the window, refund if the oracle timed out |
get_case, list_cases |
both sides, the exact oracle question, deadlines, verdict, votes; cases waiting for you |
check_payment |
a NEAR transfer, ft_transfer or x402 signed-delegate payment by tx hash, as an evidence line |
verify_verdict |
re-runs the 2-of-3 signature check on the NEAR oracle contract |
reputation |
an account's wins, losses, appeals and unanswered cases |
Environment: NEAR_RPC_URL (default https://rpc.testnet.fastnear.com), PSEPHEX_COURT (psephex-court.testnet), PSEPHEX_ORACLE (oracle.psephex.testnet), PSEPHEX_API_URL (https://psephex.xyz/api).
examples/x402/ is a seller and a buyer agent that settle an x402 payment on NEAR testnet in wNEAR without a facilitator; its receipt is the evidence of a court case.
Psephex MCP Fragen
Wie füge ich Psephex MCP zu Claude Code hinzu?
Führe claude mcp add --env NEAR_PRIVATE_KEY=<YOUR_NEAR_PRIVATE_KEY> psephex -- npx -y @unitynodes/psephex-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Psephex MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Was passiert, wenn ich keine NEAR-Zugangsdaten angebe?
Der Server wird im Read-only-Modus betrieben.
Wie kann ich begrenzen, wie viel Geld mein Agent ausgibt?
Du kannst Stakes und Appeals mit PSEPHEX_MAX_STAKE_NEAR deckeln, die gesamten Prozesskosten mit PSEPHEX_BUDGET_NEAR begrenzen oder spezifische Gegenparteien über PSEPHEX_ALLOWED_COUNTERPARTIES einschränken.
Welche Token werden für die Zahlungsverifizierung als gültig betrachtet?
Das Tool check_payment erkennt nur Token, die in PSEPHEX_TRUSTED_TOKENS gelistet sind; standardmäßig sind dies Circle testnet USDC und wrap.testnet.