> Psyseal "For developers and AI agents" page in English, as clean Markdown for AI agents (web page: https://psyseal.com/docs?lang=en). Summary: https://psyseal.com/llms.txt

# 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](https://github.com/psyseal/psyseal-scan). npm package: [psyseal-scan](https://www.npmjs.com/package/psyseal-scan).
- The [zip download](https://psyseal.com/download/psyseal-0.3.3.zip) has the same scanner plus the cleanup and seal programs of the paid plans ([guide](https://psyseal.com/guia)).

## 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](https://psyseal.com/openapi.json) of the public API.
- [Plugin manifest](https://psyseal.com/.well-known/ai-plugin.json).
- [llms.txt](https://psyseal.com/llms.txt): summary for language models.
- [API index](https://psyseal.com/api) in JSON.