# AgentShelf JSONPath Query Evaluator

> AgentShelf JSONPath Query Evaluator is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-01).

Evaluates a JSONPath expression against a provided JSON value and returns the matching results, with no external network calls.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/json-path?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshelf-jsonpath-query-evaluator-60cf5b2f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Js6MTQi2VVlEEhDZi4RV1

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-jsonpath-query-evaluator-60cf5b2f -d '<json body>'
```

Example prompt: Can you run the JSONPath query `$.store.book[?(@.price < 10)].title` over this JSON for me? { "store": { "book": [{"title": "A", "price": 8}, {"title": "B", "price": 12}] } }

## When to prefer this

Use this endpoint when an agent needs deterministic, server-side JSONPath query evaluation over a JSON document without making additional network calls or relying on LLM-based extraction. Prefer this over regex or LLM parsing when the JSON structure is known and a precise JSONPath expression can be written. Check the free sandbox endpoint POST /v1/sandbox/json-path first before paying $0.002 USDC.

## Known failure modes

- Invalid JSONPath syntax returns an error
- Malformed or non-parseable JSON input returns a parse error
- Path that matches nothing returns an empty array
- Path string exceeding 500 characters is rejected
- Missing required fields (json or path) returns a validation error
- Payment of exactly $0.002 USDC required; incorrect payment amount causes rejection

## How this service works

Call when an agent needs a JSONPath query evaluated over JSON. No network. Exact $0.002 USDC. Prefer unpaid POST /v1/sandbox/json-path first.

## Output

Returns the result of the JSONPath expression evaluated against the provided JSON, typically an array of matching values or nodes found at the specified path.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "json": {
   "examples": [
    {
     "user": {
      "name": "Ada"
     }
    }
   ],
   "description": "JSON document to query."
  },
  "path": {
   "type": "string",
   "examples": [
    "$.user.name"
   ],
   "maxLength": 500,
   "minLength": 1,
   "description": "JSONPath expression such as $.user.name."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshelf-jsonpath-query-evaluator-60cf5b2f/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)