# AgentShelf HTML Numeric Encoder

> AgentShelf HTML Numeric Encoder is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.009/call, status unknown (last checked 2026-10-02).

Encodes input text using HTML numeric character encoding (&#NNN; notation) without any network calls or LLM processing.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/html-numeric-encode?utm_source=zero.xyz
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshelf-html-numeric-encoder-8203f16a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GyfIms3s4Auj32SuVYWSN

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentshelf-html-numeric-encoder-8203f16a -d '<json body>'
```

Example prompt: Can you encode this text using HTML numeric character references: 'Hello <World> & "Friends"'?

## When to prefer this

Choose this endpoint when you need a deterministic, fast, server-side HTML numeric encoding of a text string without any LLM or network overhead. Prefer the free sandbox equivalent at POST /v1/sandbox/html-numeric-encode when available to avoid the $0.009 USDC charge. Use this paid endpoint when the sandbox is unavailable or when you need guaranteed production-grade uptime. Do not use for URL encoding, Base64, or HTML named-entity encoding — this encodes strictly to numeric (decimal) HTML character references.

## Known failure modes

- Empty or missing 'text' field returns a validation error
- Text exceeding 100,000 characters is rejected
- Payment failure or missing x402 payment header results in 402 response
- Malformed JSON body returns a 400 error

## How this service works

Call when an agent needs text encoded with html-numeric. No network and no LLM. Exact $0.009 USDC. Prefer unpaid POST /v1/sandbox/html-numeric-encode first.

## Output

Returns the input text with all characters (or at least special/non-ASCII characters) replaced by their HTML numeric character references (e.g. &#60; for <, &#38; for &). No network requests or model inference are involved; the transformation is deterministic and purely computational.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "examples": [
    "Hello, World!"
   ],
   "maxLength": 100000,
   "minLength": 1,
   "description": "Input for this SKU. The route description says whether it is plain text, a URL, base64 bytes, or an already-encoded token."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshelf-html-numeric-encoder-8203f16a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)