Para desarrolladores y agentes de IA

Cómo correr el escáner gratis desde una terminal, un cliente MCP o una skill de agente, y la API pública de Psyseal: estado de los sellos, la llave de firma y los pases x402. Para leer un sello no necesitas cuenta ni llave.

Corre el escáner gratis

npx psyseal-scan --lang es

Necesita Node.js 20 o más reciente. Solo lee archivos: no usa la red, no escribe y no corre otros programas. Agrega --path y una carpeta para revisar cualquier carpeta de agente, o --json para un reporte en JSON.
Código (MIT-0): github.com/psyseal/psyseal-scan. Paquete de npm: psyseal-scan.
La descarga en zip trae el mismo escáner y además los programas de limpieza y sello de los planes de pago (guía).

Úsalo como servidor MCP

La misma revisión de solo lectura como una herramienta, scan_agents, por stdio, para Claude, Cursor, Codex y otros clientes MCP:

{
  "mcpServers": {
    "psyseal-scan": {
      "command": "npx",
      "args": ["-y", "psyseal-scan", "mcp"]
    }
  }
}

Claude Code

claude mcp add psyseal-scan -- npx -y psyseal-scan mcp

Nombre en el registro oficial de MCP: io.github.psyseal/psyseal-scan.

Instálalo como skill de agente

OpenClaw (ClawHub)

openclaw skills install @psyseal/psyseal-scan

Claude Code, Cursor, Codex, Gemini CLI y otros agentes

npx skills add psyseal/psyseal-scan

Lee un sello (API pública)

Dirección base https://seal.psyseal.com. Solo GET, sin llave y con CORS abierto. <id> es el código de 12 caracteres de un sello.

GET /<id>: la página pública.
GET /<id>.json: el estado (active, suspended, expired o voided: vigente, suspendido, vencido o anulado), los datos firmados, la firma y la dirección de la llave.
GET /<id>.svg: la insignia. Agrega ?lang=es para español.
GET /.well-known/psyseal-seal-key.json: la llave pública Ed25519, en formato JWK.
GET /health: estado del servicio.

curl -s https://seal.psyseal.com/<id>.json

La firma (sig, en base64url) es Ed25519 sobre los datos en JSON con las llaves ordenadas y sin espacios. Psyseal firma los resultados que manda el programa del dueño; no los verifica por su cuenta. Un sello no es una certificación oficial ni una auditoría.

Paga con x402 (el agente paga solo)

Dos pases de 30 días en USDC sobre Base (eip155:8453), x402 versión 2, que no se renuevan solos: el pase completo, limpieza y sello, 8.99 USDC en POST /api/x402/pass; el pase de sello, 0.99 USDC en POST /api/x402/seal, que se cobra solo si las revisiones pasan.
Sin pago, la respuesta es 402 con el encabezado PAYMENT-REQUIRED. La cartera del agente firma el pago y lo vuelve a mandar en el encabezado PAYMENT-SIGNATURE.
Los programas del zip preparan la petición: node scripts/psyseal-fix.mjs --apply --x402 y node scripts/psyseal-seal.mjs --x402.
Solo si se paga desde Estados Unidos, Canadá, Australia, Nueva Zelanda, Japón, Singapur, Hong Kong, Suiza o Noruega; desde otros países la respuesta es 451 y aplican los planes con tarjeta. Solo con autorización del dueño.

Archivos para máquinas

OpenAPI 3.1 de la API pública.
Manifiesto de plugin.
llms.txt: resumen para modelos de lenguaje.
Índice de la API en JSON.

For developers and AI agents

How to run the free scanner from a terminal, an MCP client or an agent skill, and Psyseal's public API: seal status, the signing key and x402 passes. Reading a seal needs no account and no key.

Run the free scanner

npx psyseal-scan --lang en

Needs Node.js 20 or newer. It only reads files: no network, no writes, no other programs. Add --path followed by a folder to check any agent folder, or --json for a JSON report.
Source code (MIT-0): github.com/psyseal/psyseal-scan. npm package: psyseal-scan.
The zip download has the same scanner plus the cleanup and seal programs of the paid plans (guide).

Use it as an MCP server

The same read-only scan as one tool, scan_agents, over stdio, for Claude, Cursor, Codex and other MCP clients:

{
  "mcpServers": {
    "psyseal-scan": {
      "command": "npx",
      "args": ["-y", "psyseal-scan", "mcp"]
    }
  }
}

Claude Code

claude mcp add psyseal-scan -- npx -y psyseal-scan mcp

Name in the official MCP Registry: io.github.psyseal/psyseal-scan.

Install it as an agent skill

OpenClaw (ClawHub)

openclaw skills install @psyseal/psyseal-scan

Claude Code, Cursor, Codex, Gemini CLI and other agents

npx skills add psyseal/psyseal-scan

Read a seal (public API)

Base address https://seal.psyseal.com. GET only, no key, open CORS. <id> is the 12-character code of a seal.

GET /<id>: the public page.
GET /<id>.json: the status (active, suspended, expired or voided), the signed payload, the signature and the key address.
GET /<id>.svg: the badge. Add ?lang=es for Spanish.
GET /.well-known/psyseal-seal-key.json: the public Ed25519 key, as JWK.
GET /health: service status.

curl -s https://seal.psyseal.com/<id>.json

The signature (sig, base64url) is Ed25519 over the payload serialized as JSON with sorted keys and no spaces. Psyseal signs the results that the owner's program sends; it does not verify them on its own. A seal is not an official certification or an audit.

Pay with x402 (the agent pays by itself)

Two 30-day passes in USDC on Base (eip155:8453), x402 version 2, that do not renew automatically: the full pass, cleanup and seal, 8.99 USDC at POST /api/x402/pass; the seal pass, 0.99 USDC at POST /api/x402/seal, charged only if the checks pass.
Without a payment the answer is 402 with the PAYMENT-REQUIRED header. The agent's wallet signs the payment and sends it again in the PAYMENT-SIGNATURE header.
The programs in the zip prepare the request: node scripts/psyseal-fix.mjs --apply --x402 and node scripts/psyseal-seal.mjs --x402.
Only when paying from the United States, Canada, Australia, New Zealand, Japan, Singapore, Hong Kong, Switzerland or Norway; elsewhere the answer is 451 and the card plans apply. Only with the owner's authorization.

Machine-readable files

OpenAPI 3.1 of the public API.
Plugin manifest.
llms.txt: summary for language models.
API index in JSON.