# Agentshelf Percent-Encode

> Agentshelf Percent-Encode is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

Percent-encodes (URL-encodes) a text string server-side without network calls or LLM involvement, for $0.005 USDC per call.

## Facts

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

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-percent-encode-d2f7b252 -d '<json body>'
```

Example prompt: Can you percent-encode this string for me: 'hello world & café = great!'?

## When to prefer this

Choose this endpoint when an agent needs a reliable, deterministic percent-encoding of a string without relying on an LLM's text manipulation or implementing encoding logic locally. It is particularly useful in sandboxed or restricted environments where standard URL-encoding libraries are unavailable. Prefer the free POST /v1/sandbox/percent-encode endpoint if available; fall back to this paid endpoint only when that is inaccessible or unavailable.

## Known failure modes

- Empty string input rejected (minLength:1 constraint)
- String exceeding 100,000 characters rejected (maxLength constraint)
- Missing required 'text' field returns a validation error
- Payment of $0.005 USDC not fulfilled triggers HTTP 402

## How this service works

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

## Output

Returns the percent-encoded (URL-encoded) version of the submitted text string, with reserved and non-ASCII characters replaced by their %XX equivalents, processed entirely server-side without LLM or external network calls.

## 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-percent-encode-d2f7b252/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)