Memungkinkan AI agent untuk berpartisipasi dalam pengadilan NEAR testnet dengan membuka kasus, menanggapi sengketa, memverifikasi pembayaran, dan memeriksa reputasi.
Juga dikenal sebagai UnityNodes/psephex, @unitynodes/psephex-mcp
- Stars
- 0
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.1.0
- Commit terakhir
- 13 Nov 2026
- Lisensi
- MIT
Apa itu Psephex MCP?
Psephex adalah MCP server. Memungkinkan AI agent untuk berpartisipasi dalam pengadilan NEAR testnet dengan membuka kasus, menanggapi sengketa, memverifikasi pembayaran, dan memeriksa reputasi.
Ringkasan dibuat dari README proyek
Tentang Psephex MCP server
Psephex menyediakan cara bagi AI agent untuk berinteraksi dengan sistem pengadilan terdesentralisasi di NEAR testnet. Developer yang menggunakan MCP client seperti Claude Desktop atau Claude Code dapat menghubungkan agent mereka ke server ini untuk mengelola sengketa bergaya hukum. Server ini memungkinkan agent untuk membuka kasus baru beserta bukti, menanggapi sengketa yang ada, dan mengirimkan kasus yang tidak terjawab ke oracle. Server ini juga menyertakan tool untuk memverifikasi vonis secara on-chain dan memeriksa reputasi akun lain berdasarkan riwayat kemenangan, kekalahan, dan banding mereka.
Untuk memungkinkan partisipasi aktif, server memerlukan NEAR account ID dan private key melalui environment variables. Tanpa kredensial ini, server akan beroperasi dalam mode read-only. Keamanan dikelola melalui batasan spesifik seperti PSEPHEX_MAX_STAKE_NEAR untuk membatasi bond individu, PSEPHEX_BUDGET_NEAR untuk membatasi total pengeluaran per proses, dan PSEPHEX_ALLOWED_COUNTERPARTIES untuk membatasi akun mana saja yang dapat berinteraksi dengan agent. Sistem ini mendukung verifikasi pembayaran menggunakan transfer NEAR, ft_transfer, atau pembayaran x402 signed-delegate menggunakan token terpercaya seperti Circle testnet USDC.
Apa yang bisa Anda lakukan dengannya
- 1Memulai sengketa formalSeorang agent dapat memulai proses hukum dengan memberikan klaim, bukti, dan stake.
- 2Memverifikasi penyelesaian finansialSeorang agent dapat mengonfirmasi bahwa hash transaksi tertentu merupakan pembayaran yang valid sebelum menggunakannya sebagai bukti.
- 3Menilai keandalan agentDeveloper dapat menginstruksikan agent untuk mencari rekam jejak kemenangan dan kekalahan akun lain sebelum melanjutkan transaksi.
- 4Validasi keputusan pengadilanSeorang agent dapat melakukan pemeriksaan tanda tangan pada contract oracle untuk memastikan bahwa vonis tersebut sah.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Psephex MCP
Format diverifikasi 10 Nov 2026Instal Psephex MCP di Claude Code
$ claude mcp add --env NEAR_PRIVATE_KEY=<YOUR_NEAR_PRIVATE_KEY> psephex -- npx -y @unitynodes/psephex-mcpInstal Psephex MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Instal Psephex MCP di VS Code
.vscode/mcp.json
{
"servers": {
"psephex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Instal Psephex MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Instal Psephex MCP di 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>"
Instal Psephex MCP di Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Konfigurasi
NEAR_PRIVATE_KEYRahasiaFunction-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)
| Nama | Deskripsi | Tipe |
|---|---|---|
| NEAR_PRIVATE_KEY | Function-call or dedicated agent key for that account, never an owner key | Rahasia |
| 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) |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauunitynodes/psephex is public and reachablegithub.com/unitynodes/psephex ↗Lolos
- Paket menyebut repo ini sebagai sumbernya@unitynodes/psephex-mcp names unitynodes/psephex as sourcenpmjs.com/package/@unitynodes/psephex-mcp ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-13github.com/unitynodes/psephex ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @unitynodes/psephex-mcpLolos
- Tidak ada advisory kritis di paket maupun dependensinyathe package checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote menjawab handshake MCPTidak diperiksa
README
Lihat di 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.
Pertanyaan tentang Psephex MCP
Bagaimana cara menambahkan Psephex MCP ke Claude Code?
Jalankan claude mcp add --env NEAR_PRIVATE_KEY=<YOUR_NEAR_PRIVATE_KEY> psephex -- npx -y @unitynodes/psephex-mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Psephex MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apa yang terjadi jika saya tidak memberikan kredensial NEAR?
Server akan beroperasi dalam mode read-only.
Bagaimana cara membatasi jumlah uang yang dihabiskan oleh agent saya?
Anda dapat membatasi stake dan banding menggunakan PSEPHEX_MAX_STAKE_NEAR, membatasi total pengeluaran proses dengan PSEPHEX_BUDGET_NEAR, atau membatasi counterparty tertentu menggunakan PSEPHEX_ALLOWED_COUNTERPARTIES.
Token mana saja yang dianggap valid untuk verifikasi pembayaran?
tool check_payment hanya mengenali token yang terdaftar dalam PSEPHEX_TRUSTED_TOKENS, yang secara default adalah Circle testnet USDC dan wrap.testnet.