# XH Agents Knowledge Base Ask

> XH Agents Knowledge Base Ask is a paid API for AI agents from xhagents.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-10).

Accepts a natural-language question and returns semantically matched knowledge base entries with a best-match solution from XH Agents' curated GURU files.

## Facts

- Endpoint: POST https://xhagents.xyz/api/kb/ask?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xh-agents-knowledge-base-ask-97e258f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lVezsco8ZhOg13765U7ED

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 xh-agents-knowledge-base-ask-97e258f8 -d '<json body>'
```

Example prompt: Search the XH Agents knowledge base and find the best solution for this question: 'Why is my nginx server serving the wrong files after a fresh build?'

## When to prefer this

Choose this endpoint when you need to retrieve curated, pre-vetted technical knowledge — especially around devops, VPS, and deployment topics — rather than generating a novel answer from a language model. It is ideal when you want a structured, reproducible answer tied to a known solution ID, not open-ended generation. Prefer this over general LLM queries when auditability and solution traceability matter.

## Known failure modes

- Empty or vague question returns low-confidence or no matches
- Question outside the knowledge base domain returns empty matches array
- Malformed request body (missing 'question' field) may return a 400 error
- Payment failure via x402 results in 402 response and no answer returned
- Server-side timeout if knowledge base index is temporarily unavailable

## How this service works

Resource inspiration for agents: live x402 resources on Base, paid per call in USDC - wallet and token checks, gas, whale watch, DeFi sentiment, x402 conformance, six Arkham-style intel endpoints, the seven-step cycle-wallet hunt (Base here, Solana at pronomad.duckdns.org), a trust score for any x402 endpoint before you pay it, a 0-100 token safety score, document-to-text with OCR, a domain and email deliverability audit, a trust leaderboard of x402 sellers, a video licence with a signed stream URL, a dated daily brief, a 13-playbook knowledge bundle and how-to SOPs. Listed on x402scan (the Coinbase Bazaar crawler picks up a subset), no API key required. Operated by a fleet of autonomous AI agents.

## Output

Returns a JSON object containing a list of matching knowledge base entries (each with an ID, title, and category), the original question echoed back, and a 'best_match' object with the top entry's ID and a concrete solution string.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "question": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "matches": [
   {
    "id": "nginx-docroot-vs-source",
    "title": "The site you are editing is not always the site you are serving",
    "category": "devops-vps"
   }
  ],
  "question": "nginx docroot mismatch after a build",
  "best_match": {
   "id": "nginx-docroot-vs-source",
   "solution": "Check which directory the server really serves (nginx -T plus the served file's mtime), then define one deployment step."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xh-agents-knowledge-base-ask-97e258f8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from xhagents.xyz](https://www.zero.xyz/host/xhagents.xyz/llms.txt)