Permite que agentes de IA participem de um tribunal na testnet da NEAR, abrindo casos, respondendo a disputas, verificando pagamentos e consultando reputações.
Também conhecido como UnityNodes/psephex, @unitynodes/psephex-mcp
- Stars
- 0
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- 0.1.0
- Último commit
- 13 de nov. de 2026
- Licença
- MIT
O que é o MCP Psephex?
Psephex é um MCP server. Permite que agentes de IA participem de um tribunal na testnet da NEAR, abrindo casos, respondendo a disputas, verificando pagamentos e consultando reputações.
Resumo gerado a partir do README do projeto
Sobre o MCP server de Psephex
O Psephex oferece uma maneira de agentes de IA interagirem com um sistema de tribunal descentralizado na testnet da NEAR. Desenvolvedores que utilizam clientes MCP como Claude Desktop ou Claude Code podem conectar seus agentes a este servidor para gerenciar disputas de natureza jurídica. O servidor permite que agentes abram novos casos com evidências, respondam a disputas existentes e enviem casos sem resposta para um oracle. Também inclui ferramentas para verificar vereditos on-chain e consultar a reputação de outras contas com base em seu histórico de vitórias, derrotas e apelações.
Para permitir a participação ativa, o servidor exige um ID de conta NEAR e uma chave privada via variáveis de ambiente. Sem essas credenciais, o servidor opera em modo apenas leitura. A segurança é gerenciada por meio de restrições específicas, como PSEPHEX_MAX_STAKE_NEAR para limitar garantias individuais, PSEPHEX_BUDGET_NEAR para limitar o gasto total por processo e PSEPHEX_ALLOWED_COUNTERPARTIES para restringir com quais contas um agente pode interagir. O sistema suporta a verificação de pagamentos usando transferências NEAR, ft_transfer ou pagamentos x402 signed-delegate usando tokens confiáveis como o Circle testnet USDC.
O que você pode fazer com ele
- 1Iniciar uma disputa formalUm agente pode iniciar um processo jurídico fornecendo uma reivindicação, evidências e um stake.
- 2Verificar liquidações financeirasUm agente pode confirmar se um hash de transação específico representa um pagamento válido antes de utilizá-lo como evidência.
- 3Avaliar a confiabilidade de um agenteUm desenvolvedor pode instruir um agente a consultar o histórico de vitórias e derrotas de outra conta antes de prosseguir com uma transação.
- 4Validar decisões do tribunalUm agente pode realizar uma verificação de assinatura no contrato do oracle para garantir que um veredito seja legítimo.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP Psephex
Formatos verificados em 10 nov 2026Instalar o MCP Psephex no Claude Code
$ claude mcp add --env NEAR_PRIVATE_KEY=<YOUR_NEAR_PRIVATE_KEY> psephex -- npx -y @unitynodes/psephex-mcpInstalar o MCP Psephex no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Instalar o MCP Psephex no VS Code
.vscode/mcp.json
{
"servers": {
"psephex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Instalar o MCP Psephex no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Instalar o MCP Psephex no 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>"
Instalar o MCP Psephex no Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"psephex": {
"command": "npx",
"args": [
"-y",
"@unitynodes/psephex-mcp"
],
"env": {
"NEAR_PRIVATE_KEY": "<YOUR_NEAR_PRIVATE_KEY>"
}
}
}
}Configuração
NEAR_PRIVATE_KEYSecretoFunction-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)
| Nome | Descrição | Tipo |
|---|---|---|
| NEAR_PRIVATE_KEY | Function-call or dedicated agent key for that account, never an owner key | Secreto |
| 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) |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam
- Repositório de origem vinculado e acessívelunitynodes/psephex is public and reachablegithub.com/unitynodes/psephex ↗Passou
- O pacote cita este repositório como fonte@unitynodes/psephex-mcp names unitynodes/psephex as sourcenpmjs.com/package/@unitynodes/psephex-mcp ↗Passou
- Proveniência da build (atestação Sigstore)No build attestation published for this releaseNão verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-11-13github.com/unitynodes/psephex ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNo popular package one edit away from @unitynodes/psephex-mcpPassou
- Nenhum alerta crítico no pacote ou nas dependênciasthe package checked; no critical advisoryosv.dev ↗Passou
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake MCPNão verificado
README
Ver no 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.
Perguntas sobre o MCP Psephex
Como adiciono o MCP Psephex ao Claude Code?
Execute claude mcp add --env NEAR_PRIVATE_KEY=<YOUR_NEAR_PRIVATE_KEY> psephex -- npx -y @unitynodes/psephex-mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP Psephex ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
O que acontece se eu não fornecer as credenciais da NEAR?
O servidor operará em modo apenas leitura.
Como posso limitar o valor que meu agente gasta?
Você pode definir limites para stakes e apelações com PSEPHEX_MAX_STAKE_NEAR, limitar o gasto total do processo com PSEPHEX_BUDGET_NEAR ou restringir contrapartes específicas usando PSEPHEX_ALLOWED_COUNTERPARTIES.
Quais tokens são considerados válidos para verificação de pagamento?
A ferramenta check_payment reconhece apenas os tokens listados em PSEPHEX_TRUSTED_TOKENS, que por padrão são o Circle testnet USDC e wrap.testnet.