Skip to main content
CITEROUTE
Protocol Documentation v1.2

agent.json Specification

The agent.json protocol is a machine-readable standard deployed at /.well-known/agent.json that enables AI search engines and autonomous buyer agents to discover, query, and transact with your website - without human intermediary lag.

Install Tracking Snippetagent.json Studio

What Is agent.json?

Machine-Readable API

Transforms any website into an autonomous agent endpoint. AI assistants can discover your capabilities, products, and pricing programmatically.

Controlled Access

Define rate limits, auth requirements, and which agent crawlers are allowed. You stay in full control of who accesses your data.

Zero-Click Transactions

Personal AI buyer agents can discover products and execute checkout orders in milliseconds - no human browsing needed.

Schema Reference

FieldTypeRequiredDescription
versionstringProtocol version (e.g. "1.2.0"). Used by crawlers to determine feature support.
siteNamestringHuman-readable name of your site or platform.
domainstringPrimary domain hostname (e.g. "stripe.com").
descriptionstringSemantic description optimized for LLM context windows. Include key capabilities and differentiators.
organizationobjectPublisher metadata: legalName, foundedYear, headquarters, contactEmail.
capabilitiesstring[]Array of supported agent capabilities: "direct-agent-checkout", "semantic-api-query", "realtime-geo-audit", etc.
endpointsEndpoint[]Array of service endpoints that autonomous agents can invoke. Each has: id, name, path, method, description, authRequired, pricingType.
productsProduct[]-Optional product catalog for direct agent checkout. Each has: id, name, sku, price, currency, category, inStock, directAgentCheckoutUrl.
semanticVectorsobject-Links to pre-computed embeddings (embeddingsUrl, contextSizeTokens, lastUpdated) for RAG integration.
accessPolicyobjectControls: allowAgentCrawlers (boolean), allowDirectTransactions (boolean), rateLimitPerMin (number).

Minimal Example

{
  "version": "1.2.0",
  "siteName": "Your Brand",
  "domain": "yourbrand.com",
  "description": "Your brand's agent-friendly description for LLM context.",
  "organization": {
    "legalName": "Your Brand Inc.",
    "foundedYear": 2024,
    "headquarters": "San Francisco, CA",
    "contactEmail": "agents@yourbrand.com"
  },
  "capabilities": ["direct-agent-checkout", "semantic-api-query"],
  "endpoints": [
    {
      "id": "ep-1",
      "name": "Product Catalog API",
      "path": "/api/agent/catalog",
      "method": "GET",
      "description": "Returns full product catalog for autonomous buyer agents.",
      "authRequired": false,
      "pricingType": "free"
    }
  ],
  "accessPolicy": {
    "allowAgentCrawlers": true,
    "allowDirectTransactions": true,
    "rateLimitPerMin": 600
  }
}

Deployment Guide

1

Use the agent.json Studio to generate your manifest with the Visual Builder.

2

Copy the deployment snippet for your platform (Next.js, Cloudflare Worker, FastAPI, or the Edge Worker with bot detection).

3

Deploy and verify at https://yourdomain.com/.well-known/agent.json

4

Run a GEO Audit to verify AI engines can discover your manifest.

Open agent.json Studio