Semantic documentation search across 10 pre-indexed platforms for AI agents via x402 micropayments.
What it does
AgentUtil Docs provides instant, semantic documentation search for AI agents. It pre-indexes documentation from 10 platforms — Shopify, Stripe, Cloudflare Workers, Next.js, Anthropic, OpenAI, Tailwind CSS, htmx, x402, and Jesse — totaling roughly 38,000 chunks. Instead of keyword matching or per-page scraping, agents send a natural language query along with a platform identifier and receive the most relevant documentation chunks back, each with source URLs, page titles, section headings, and relevance scores. Queries resolve in under 100ms thanks to edge-based embedding and offline indexing.
The service exposes two paid endpoints and several free ones. POST /query performs semantic search ($0.003 per request via x402/USDC on Base), returning up to 10 ranked chunks per call. POST /lookup retrieves all chunks for a specific documentation page by identifier ($0.002 per request). Free endpoints include GET /platforms (lists all indexed platforms with page counts), GET /platforms/:id/schema (full table of contents), and POST /request (signal demand for new platforms to be indexed). A free tier of 10 queries per day per IP is available with no signup required.
The API follows a straightforward JSON request/response pattern. The OpenAPI 3.1.0 spec is published at /openapi.json, and agent discovery metadata is available via .well-known/agent-service.json and .well-known/agent.json. Payment is handled through the x402 protocol using USDC on the Base chain.
Capabilities
Use cases
- —AI coding agents retrieving up-to-date API documentation mid-task
- —Chatbots answering developer questions with sourced documentation snippets
- —Automated workflows that need to look up platform-specific API details
- —RAG pipelines augmenting LLM context with official documentation chunks
- —Multi-platform documentation aggregation for developer tooling
Fit
Best for
- —AI agents that need fast, contextual documentation lookups across multiple platforms
- —Developers building tools that query Shopify, Stripe, Cloudflare, OpenAI, or Anthropic docs programmatically
- —Cost-sensitive use cases where per-page scraping is too expensive or slow
Not for
- —Searching documentation for platforms not in the pre-indexed set of 10
- —Full-text retrieval of entire documentation sites (returns chunks, not full pages)
- —Non-developer documentation or general web search
Quick start
curl -X POST https://docs.agentutil.net/query \
-H "Content-Type: application/json" \
-d '{
"platform": "shopify",
"query": "how to create a product variant",
"max_chunks": 3
}'Example
Request
{
"query": "how to create a product variant",
"platform": "shopify",
"max_chunks": 3
}Response
{
"query": "how to create a product variant",
"results": [
{
"content": "The productVariantCreate mutation creates a new product variant...",
"section": "Mutations",
"page_title": "productVariantCreate",
"source_url": "https://shopify.dev/docs/api/admin-graphql/2024-01/mutations/productVariantCreate",
"last_crawled": "2025-01-15T00:00:00Z",
"relevance_score": 0.94
},
{
"content": "You can add variants to an existing product using the Admin API...",
"section": "Objects",
"page_title": "ProductVariant",
"source_url": "https://shopify.dev/docs/api/admin-graphql/2024-01/objects/ProductVariant",
"last_crawled": "2025-01-15T00:00:00Z",
"relevance_score": 0.87
}
],
"platform": "shopify",
"total_matches": 15,
"chunks_returned": 2
}Endpoint
Quality
Full OpenAPI 3.1.0 schema with request/response definitions, clear pricing, agent discovery metadata, and a working landing page. The x402 probe returned 400 rather than 402 (likely because the free tier served the request or the POST body was empty/malformed), so the x402 payment challenge was not directly captured. Documentation beyond the landing page is sparse (all sub-paths return 404).
Warnings
- —x402 probe did not return a 402 challenge — endpoint returned 400 on POST, possibly due to missing required body fields; x402 payment flow not directly verified
- —Only 10 platforms are indexed; coverage is fixed and cannot be expanded on demand
- —No actual 200 response was captured during probing to confirm live data returns
Citations
- —10 platforms pre-indexed: Shopify, Stripe, Cloudflare Workers, Next.js, Anthropic, OpenAI, Tailwind CSS, htmx, x402, Jessehttps://docs.agentutil.net
- —~38K chunks across 10 platformshttps://docs.agentutil.net
- —POST /query costs $0.003 per request, POST /lookup costs $0.002 per requesthttps://docs.agentutil.net
- —Free tier: 10 queries/day per IP, no signuphttps://docs.agentutil.net
- —Queries resolve in <100mshttps://docs.agentutil.net
- —Payment via x402 protocol, USDC on Basehttps://docs.agentutil.net
- —OpenAPI spec and agent discovery metadata available at well-known pathshttps://docs.agentutil.net