# Aayat AI Error Explainer

> Aayat AI Error Explainer is a paid API for AI agents from aayatai.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-02).

Searches GitHub issues and Stack Overflow for matching error reports, reads top answers, and returns a cited explanation with likely cause and concrete fix steps.

## Facts

- Endpoint: GET https://aayatai.com/error/explain?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aayat-ai-error-explainer-f39c86bb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__jzf94IZpLtEP6lMNw4fg

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 aayat-ai-error-explainer-f39c86bb
```

Example prompt: I'm getting 'Error: Cannot find module "hono/cors"' in my TypeScript project — can you search GitHub issues and Stack Overflow for what's causing it and give me specific steps to fix it? The library is hono and the ecosystem is npm.

## When to prefer this

Choose this endpoint when you need a grounded, source-cited explanation for a specific error message or stack trace, especially for popular open-source libraries across npm, pypi, Rust (crates), or Go ecosystems. It is preferable over generic LLM completions when you want answers backed by real GitHub issues and Stack Overflow accepted answers rather than hallucinated fixes. Best for errors in well-known libraries with public issue trackers.

## Known failure modes

- No matching issues or answers found — endpoint returns known:false and says so plainly
- Error message too short (under 5 characters) — rejected by schema validation
- Error message too long (over 4000 characters) — rejected by schema validation
- Unsupported ecosystem value — only npm, pypi, crates, go are accepted
- GitHub or Stack Overflow APIs unavailable — sources array may show ok:false for affected sources
- Highly unique or internal error with no public matches — returns empty matches array

## How this service works

Explain and fix an error: finds matching GitHub issues and Stack Overflow questions (like /error/known), reads the top accepted answers in full, then writes the likely cause and concrete fix steps citing those sources, and says plainly when nothing matching was found. Paste the error (stack traces fine) and optionally the library.

## Output

A JSON object containing: a boolean indicating whether the error is known, the cleaned search query used, matched GitHub issues and Stack Overflow questions with titles, URLs, relevance scores, status, and excerpts, a summary of how many matches were found and solved, and a Markdown explanation with likely cause and numbered fix steps citing the matched sources.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "message"
     ],
     "properties": {
      "library": {
       "type": "string",
       "maxLength": 214,
       "description": "The package the error comes from, to search its own issues first."
      },
      "message": {
       "type": "string",
       "maxLength": 4000,
       "minLength": 5,
       "description": "The error message (a stack trace is fine; paths and line numbers are stripped)."
      },
      "ecosystem": {
       "enum": [
        "npm",
        "pypi",
        "crates",
        "go"
       ],
       "type": "string",
       "default": "npm",
       "description": "Package ecosystem: npm, pypi, crates (Rust) or go (Go modules)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "known",
      "summary",
      "matches",
      "sources",
      "explanation"
     ],
     "properties": {
      "known": {
       "type": "boolean"
      },
      "query": {
       "type": "string",
       "description": "The cleaned-up phrase that was searched."
      },
      "trust": {
       "type": "object",
       "description": "Third-party text, cleaned: read trust.notice; removed = what we stripped."
      },
      "library": {
       "type": [
        "string",
        "null"
       ]
      },
      "matches": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "url": {
          "type": "string"
         },
         "score": {
          "type": "integer"
         },
         "title": {
          "type": "string"
         },
         "source": {
          "enum": [
           "github-issue",
           "stackoverflow"
          ],
          "type": "string"
         },
         "status": {
          "type": "string",
          "description": "open / closed / accepted answer / answered / unanswered."
         },
         "answers": {
        
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "known": true,
  "query": "Error: Cannot find module 'hono/cors'",
  "library": "hono",
  "matches": [
   {
    "url": "https://github.com/honojs/hono/issues/1",
    "score": 12,
    "title": "Cannot find module 'hono/cors' with moduleResolution node",
    "source": "github-issue",
    "status": "closed",
    "answers": 8,
    "excerpt": "Set moduleResolution to bundler...",
    "createdAt": "2026-01-01T00:00:00Z",
    "relevance": 1
   }
  ],
  "sources": [
   {
    "ok": true,
    "name": "github-issues",
    "count": 1
   },
   {
    "ok": true,
    "name": "stackoverflow",
    "count": 1
   }
  ],
  "summary": "2 similar report(s); 1 solved (closed issue or accepted answer).",
  "checkedAt": "2026-09-28T12:00:00.000Z",
  "repository": "https://github.com/honojs/hono",
  "explanation": "## Likely cause\nYour TypeScript moduleResolution can't read package exports [1].\n\n## Fix\n1. Set \"moduleResolution\": \"bundler\" [1]."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aayat-ai-error-explainer-f39c86bb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aayatai.com](https://www.zero.xyz/host/aayatai.com/llms.txt)