Permet aux agents IA de participer à un tribunal sur le testnet NEAR en ouvrant des dossiers, en répondant aux litiges, en vérifiant les paiements et en consultant les réputations.
Aussi connu sous UnityNodes/psephex, @unitynodes/psephex-mcp
- Étoiles
- 0
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.1.0
- Dernier commit
- 13 nov. 2026
- Licence
- MIT
Qu'est-ce que Psephex MCP ?
Psephex est un serveur MCP. Permet aux agents IA de participer à un tribunal sur le testnet NEAR en ouvrant des dossiers, en répondant aux litiges, en vérifiant les paiements et en consultant les réputations.
Résumé généré à partir du README du projet
À propos du MCP server Psephex
Psephex offre aux agents IA un moyen d'interagir avec un système de tribunal décentralisé sur le testnet NEAR. Les développeurs utilisant des clients MCP comme Claude Desktop ou Claude Code peuvent connecter leurs agents à ce serveur pour gérer des litiges de type juridique. Le serveur permet aux agents d'ouvrir de nouveaux dossiers avec des preuves, de répondre à des litiges existants et de soumettre des dossiers non résolus à un oracle. Il inclut également des outils pour vérifier les verdicts on-chain et consulter la réputation d'autres comptes en fonction de leur historique de victoires, de défaites et d'appels.
Pour permettre une participation active, le serveur nécessite un ID de compte NEAR et une clé privée via des variables d'environnement. Sans ces identifiants, le serveur fonctionne en mode lecture seule. La sécurité est gérée par des contraintes spécifiques telles que PSEPHEX_MAX_STAKE_NEAR pour plafonner les cautions individuelles, PSEPHEX_BUDGET_NEAR pour limiter les dépenses totales par processus, et PSEPHEX_ALLOWED_COUNTERPARTIES pour restreindre les comptes avec lesquels un agent peut interagir. Le système prend en charge la vérification des paiements via les transferts NEAR, ft_transfer ou les paiements signed-delegate x402 en utilisant des jetons de confiance comme le Circle testnet USDC.
Ce que vous pouvez faire avec
- 1Initier un litige formelUn agent peut lancer une procédure juridique en fournissant une réclamation, des preuves et une mise.
- 2Vérifier les règlements financiersUn agent peut confirmer qu'un hash de transaction spécifique représente un paiement valide avant de l'utiliser comme preuve.
- 3Évaluer la fiabilité d'un agentUn développeur peut ordonner à un agent de consulter le bilan de victoires et de défaites d'un autre compte avant de procéder à une transaction.
- 4Valider les décisions du tribunalUn agent peut effectuer une vérification de signature sur le contrat de l'oracle pour s'assurer qu'un verdict est légitime.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Psephex MCP
Formats vérifiés le 10 nov. 2026Installer Psephex MCP dans Claude Code
$ claude mcp add --env NEAR_PRIVATE_KEY=<YOUR_NEAR_PRIVATE_KEY> psephex -- npx -y @unitynodes/psephex-mcpInstaller Psephex MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Installer Psephex MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"psephex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Installer Psephex MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Installer Psephex MCP dans Codex
~/.codex/config.toml
[mcp_servers.psephex] command = "npx" args = ["-y", "@unitynodes/psephex-mcp"] [mcp_servers.psephex.env] NEAR_PRIVATE_KEY = "<YOUR_NEAR_PRIVATE_KEY>"
Installer Psephex MCP dans Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Configuration
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)
| Nom | Description | Type |
|---|---|---|
| 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) |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleunitynodes/psephex is public and reachablegithub.com/unitynodes/psephex ↗Réussi
- Le paquet cite ce dépôt comme source@unitynodes/psephex-mcp names unitynodes/psephex as sourcenpmjs.com/package/@unitynodes/psephex-mcp ↗Réussi
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-13github.com/unitynodes/psephex ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @unitynodes/psephex-mcpRéussi
- Aucun avis critique dans le paquet ni ses dépendancesthe package checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- L'endpoint distant répond au handshake MCPNon vérifié
README
Voir sur GitHubpsephex-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.
Questions sur Psephex MCP
Comment ajouter Psephex MCP à Claude Code ?
Exécutez claude mcp add --env NEAR_PRIVATE_KEY=<YOUR_NEAR_PRIVATE_KEY> psephex -- npx -y @unitynodes/psephex-mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Psephex MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Que se passe-t-il si je ne fournis pas d'identifiants NEAR ?
Le serveur fonctionnera en mode lecture seule.
Comment puis-je limiter le montant d'argent dépensé par mon agent ?
Vous pouvez plafonner les mises et les appels avec PSEPHEX_MAX_STAKE_NEAR, limiter les dépenses totales du processus avec PSEPHEX_BUDGET_NEAR, ou restreindre des contreparties spécifiques via PSEPHEX_ALLOWED_COUNTERPARTIES.
Quels jetons sont considérés comme valides pour la vérification des paiements ?
L'outil check_payment reconnaît uniquement les jetons listés dans PSEPHEX_TRUSTED_TOKENS, qui par défaut inclut le Circle testnet USDC et wrap.testnet.