# Verdoc AGENTS.md Generator

> Verdoc AGENTS.md Generator is a paid API for AI agents from verdoc-x402.verdoc-x402-worker.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-01).

Analyzes a public GitHub repository deterministically and generates an AGENTS.md file with quoted commands and verified file paths from the repository's manifest and git tree.

## Facts

- Endpoint: GET https://verdoc-x402.verdoc-x402-worker.workers.dev/agents-md?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/verdoc-agents-md-generator-eb5f6f15
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HUkMOHWC-TXYUi06lVDdy

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 verdoc-agents-md-generator-eb5f6f15
```

Example prompt: Generate a deterministic AGENTS.md for the github.com/vercel/next.js repository and return it as markdown ready to write to disk.

## When to prefer this

Choose this endpoint when you need a reproducible, hallucination-free AGENTS.md for a public GitHub repository — particularly when you require provenance guarantees (every command quoted from a manifest, every path checked against the git tree). Prefer it over LLM-based documentation generators when auditability, determinism, and verifiability per commit are requirements. Not suitable for private repositories, very large monorepos exceeding 20,000 tracked files, or repositories where you simply need free-form AI-written documentation.

## Known failure modes

- Private repository submitted — service only accepts public repositories
- Repository has more than 20,000 tracked files — git tree is truncated by GitHub and results cannot be guaranteed complete, so the request is rejected
- Repository not found or invalid owner/name format
- GitHub API rate limiting or connectivity issues
- No manifest or recognized AGENTS.md-relevant files found in the repository

## How this service works

Deterministic GitHub repository analysis and AGENTS.md generation. No language model is used: every command is quoted from a manifest in the repository and every path is checked against the git tree, so results are reproducible for a given commit.

## Output

Returns either a JSON object containing the generated AGENTS.md document with full provenance (quoting the manifest source and confirming each path against the git tree) or the raw AGENTS.md as text/markdown, depending on the format parameter. All commands are quoted from the repository manifest and all paths are verified against the complete git tree for the given commit.

## 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",
     "properties": {
      "repo": {
       "type": "string",
       "description": "Public GitHub repository as owner/name or a github.com URL. Private repositories are rejected. Repositories with more than 20,000 tracked files are rejected too: GitHub truncates the git tree above that, and every claim this service makes depends on having the COMPLETE tree. Very large monorepos (e.g. rust-lang/rust) are therefore out of scope."
      },
      "format": {
       "enum": [
        "json",
        "markdown"
       ],
       "type": "string",
       "default": "json",
       "description": "Response format. Omit or pass 'json' for the document plus its provenance. Pass 'markdown' to get the raw AGENTS.md file as text/markdown, ready to write to disk unchanged."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/verdoc-agents-md-generator-eb5f6f15/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from verdoc-x402.verdoc-x402-worker.workers.dev](https://www.zero.xyz/host/verdoc-x402.verdoc-x402-worker.workers.dev/llms.txt)