# Setu.Anantasutra: Agent Tools API

> Pay-per-call JSON tools for AI agents: Indian identifier validation (GSTIN, PAN, TAN, CIN, LLPIN, IFSC, PIN code, UPI ID, vehicle registration), AI-visibility (GEO) audits, AI crawler robots.txt matrices and llms.txt checks. No account or API key is needed: each call is paid with x402 (USDC on Base); the same API is also sold as a RapidAPI subscription.

How payment works: call an endpoint; an unpaid call returns HTTP 402 with x402 v2 payment requirements in the PAYMENT-REQUIRED header (scheme "exact", network eip155:8453). Any x402 client (for example @x402/fetch) signs the USDC authorization and retries with a PAYMENT-SIGNATURE header. A call that fails with an error status is not settled, so it costs nothing. Results are computed on request and not stored.

## API

- [OpenAPI 3.1 specification](https://setu.xyz23110928.workers.dev/openapi.json): request and response schemas, prices (x-payment-info) and examples
- [Documentation](https://setu.xyz23110928.workers.dev/): prices, payment options, terms and privacy
- [Limits](https://setu.xyz23110928.workers.dev/#limits): request size, batch size, timeouts, allowed targets and which failures are not charged
- [MCP endpoint](https://setu.xyz23110928.workers.dev/mcp): the same tools over the Model Context Protocol (Streamable HTTP); tool calls are paid with x402 via _meta["x402/payment"]

## Endpoints

- [POST /v1/india-id/validate](https://setu.xyz23110928.workers.dev/#india-id-validate): Validate and decode one Indian identifier. $0.005 per call.
- [POST /v1/india-id/validate-batch](https://setu.xyz23110928.workers.dev/#india-id-validate-batch): Validate up to 50 Indian identifiers. $0.02 per call.
- [GET /v1/geo/audit](https://setu.xyz23110928.workers.dev/#geo-audit): AI visibility (GEO) audit for one URL. $0.02 per call.
- [GET /v1/geo/ai-crawlers](https://setu.xyz23110928.workers.dev/#ai-crawlers): AI crawler access matrix from robots.txt. $0.01 per call.
- [GET /v1/llms-txt/check](https://setu.xyz23110928.workers.dev/#llms-txt-check): llms.txt presence and structure check. $0.005 per call.

## Optional

- [Health](https://setu.xyz23110928.workers.dev/health): service status and payment configuration
- [x402 manifest](https://setu.xyz23110928.workers.dev/.well-known/x402): paid resources in the draft well-known format
