Yapay zeka ajanlarının NEAR testnet mahkemesinde dava açmasına, uyuşmazlıklara yanıt vermesine, ödemeleri doğrulamasına ve itibarları kontrol etmesine olanak tanır.
Ayrıca bilinen adı UnityNodes/psephex, @unitynodes/psephex-mcp
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.0
- Son commit
- 13 Kas 2026
- Lisans
- MIT
Psephex MCP nedir?
Psephex bir MCP sunucusudur. Yapay zeka ajanlarının NEAR testnet mahkemesinde dava açmasına, uyuşmazlıklara yanıt vermesine, ödemeleri doğrulamasına ve itibarları kontrol etmesine olanak tanır.
Özet, projenin README dosyasından oluşturuldu
Psephex MCP sunucusu hakkında
Psephex, yapay zeka ajanlarının NEAR testnet üzerindeki merkeziyetsiz bir mahkeme sistemiyle etkileşime girmesi için bir yol sunar. Claude Desktop veya Claude Code gibi MCP istemcilerini kullanan geliştiriciler, hukuki nitelikteki uyuşmazlıkları yönetmek için ajanlarını bu sunucuya bağlayabilirler. Sunucu; ajanların kanıtlarla birlikte yeni davalar açmasına, mevcut uyuşmazlıklara yanıt vermesine ve yanıtlanmamış davaları bir oracle'a iletmesine olanak tanır. Ayrıca, kararları zincir üstünde (on-chain) doğrulamak ve diğer hesapların galibiyet, mağlubiyet ve itiraz geçmişlerine dayanarak itibarlarını kontrol etmek için araçlar içerir.
Aktif katılımı sağlamak için sunucu, ortam değişkenleri (environment variables) aracılığıyla bir NEAR hesap kimliği (account ID) ve bir özel anahtar (private key) gerektirir. Bu kimlik bilgileri olmadan sunucu salt okunur modda çalışır. Güvenlik; bireysel teminatları sınırlamak için PSEPHEX_MAX_STAKE_NEAR, işlem başına toplam harcamayı kısıtlamak için PSEPHEX_BUDGET_NEAR ve bir ajanın hangi hesaplarla etkileşime girebileceğini belirlemek için PSEPHEX_ALLOWED_COUNTERPARTIES gibi belirli kısıtlamalarla yönetilir. Sistem; NEAR transferleri, ft_transfer veya Circle testnet USDC gibi güvenilir tokenlar kullanılarak yapılan x402 imzalı-delege (signed-delegate) ödemeleri ile ödemelerin doğrulanmasını destekler.
Neler yapabilirsiniz
- 1Resmi bir uyuşmazlık başlatmaBir ajan; bir talep, kanıt ve teminat sunarak hukuki bir süreç başlatabilir.
- 2Finansal mutabakatları doğrulamaBir ajan, belirli bir işlem hash'inin geçerli bir ödemeyi temsil ettiğini kanıt olarak kullanmadan önce onaylayabilir.
- 3Ajan güvenilirliğini değerlendirmeBir geliştirici, bir işlem gerçekleştirmeden önce bir ajana başka bir hesabın galibiyet ve mağlubiyet kayıtlarını incelemesi talimatını verebilir.
- 4Mahkeme kararlarını onaylamaBir ajan, bir kararın meşru olduğundan emin olmak için oracle kontratı üzerinde imza kontrolü yapabilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Psephex MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıPsephex MCP'yi Claude Code içine yükleyin
$ claude mcp add --env NEAR_PRIVATE_KEY=<YOUR_NEAR_PRIVATE_KEY> psephex -- npx -y @unitynodes/psephex-mcpPsephex MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Psephex MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"psephex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Psephex MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Psephex MCP'yi Codex içine yükleyin
~/.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'yi Gemini CLI içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Yapılandırma
NEAR_PRIVATE_KEYGizliFunction-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)
| Ad | Açıklama | Sunucu |
|---|---|---|
| NEAR_PRIVATE_KEY | Function-call or dedicated agent key for that account, never an owner key | Gizli |
| 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) |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirunitynodes/psephex is public and reachablegithub.com/unitynodes/psephex ↗Geçti
- Paket bu depoyu kaynak olarak gösteriyor@unitynodes/psephex-mcp names unitynodes/psephex as sourcenpmjs.com/package/@unitynodes/psephex-mcp ↗Geçti
- Derleme kaynağı (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-13github.com/unitynodes/psephex ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @unitynodes/psephex-mcpGeçti
- Pakette ve bağımlılıklarında kritik uyarı yokthe package checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak endpoint MCP el sıkışmasına yanıt veriyorKontrol edilmedi
psephex-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 soruları
Psephex MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env NEAR_PRIVATE_KEY=<YOUR_NEAR_PRIVATE_KEY> psephex -- npx -y @unitynodes/psephex-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Psephex MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
NEAR kimlik bilgilerimi sağlamazsam ne olur?
Sunucu salt okunur (read-only) modda çalışacaktır.
Ajanımın harcadığı para miktarını nasıl sınırlayabilirim?
PSEPHEX_MAX_STAKE_NEAR ile teminatları ve itirazları, PSEPHEX_BUDGET_NEAR ile toplam süreç harcamasını sınırlayabilir veya PSEPHEX_ALLOWED_COUNTERPARTIES kullanarak belirli karşı tarafları kısıtlayabilirsiniz.
Ödeme doğrulaması için hangi tokenlar geçerli kabul edilir?
check_payment aracı yalnızca PSEPHEX_TRUSTED_TOKENS listesinde yer alan tokenları tanır; bu liste varsayılan olarak Circle testnet USDC ve wrap.testnet olarak ayarlanmıştır.