Agentic Optimization

Agentic Optimization tests whether your e-commerce store is ready for AI agent commerce. AI agents like ChatGPT, Gemini, and Copilot are increasingly able to browse, compare, and purchase products on behalf of users. The Universal Commerce Protocol (UCP) is the standard that enables this.

What is UCP?

UCP is a protocol that allows AI agents to discover, interact with, and complete purchases on merchant websites. It works through a machine-readable profile at /.well-known/ucp.json that describes your store's capabilities, API endpoints, and checkout flow.

Without UCP compliance, AI agents cannot browse your product catalog or process orders on your site.

Running a validation

1. Navigate to Agentic Optimization in the sidebar
2. Enter your merchant URL (e.g., https://store.example.com)
3. Choose a validation type
4. Click Run Validation

Validation types

Type	Duration	What it checks
Quick Scan	~30 seconds	Fetches and validates your ucp.json profile structure, required fields, and capability declarations
Full Audit	~60 seconds	Complete AI agent simulation including discovery, API access, checkout flow, and payment readiness

Start with a Quick Scan to confirm your UCP profile exists and is correctly formatted. Use Full Audit for a comprehensive assessment that simulates the entire agent interaction.

Score breakdown

The Full Audit produces an overall score (0–100) broken into four categories.

Discovery

Can AI agents find your UCP profile? Tests profile accessibility at /.well-known/ucp.json and metadata completeness.

API Access

Can AI agents interact with your store's API? Tests REST endpoint responsiveness, schema validation, and sample operations.

Checkout Flow

Can AI agents complete a purchase? Tests checkout session creation, order flow support, and fulfillment capability.

Payment Ready

Are payment handlers correctly configured? Tests signing key validity, webhook verification, and payment handler availability.

Each category shows a progress bar with its score. Bars are color-coded:

Color	Score range	Meaning
Green	70%+	Passing
Yellow	40–69%	Partial compliance
Red	Below 40%	Failing

Letter grades

Your overall score maps to a letter grade.

Grade	Score	Meaning
A	90–100	Fully AI-agent ready
B	80–89	Good — minor improvements needed
C	70–79	Fair — moderate issues to address
D	60–69	Poor — significant problems
F	Below 60	Failing — critical issues blocking agent commerce

Validation steps

The results show each step the validator executed with its status:

• Passed (green check) — Step completed successfully
• Failed (red cross) — Step encountered an error
• Warning (yellow triangle) — Step completed with issues
• Skipped (gray arrow) — Step was not applicable

Each step shows the time it took in milliseconds, helping you identify performance bottlenecks.

Recommendations

Below the results, actionable recommendations tell you exactly what to fix. Examples:

• "Add payment handlers to the payment_ready section"
• "Enable REST transport for the Order service"
• "Ensure all endpoints use HTTPS"

Common validation errors

Error code	What it means
UCP_MISSING_ROOT	No UCP profile found at /.well-known/ucp.json
UCP_ENDPOINT_NOT_HTTPS	Endpoints must use HTTPS
UCP_MISSING_SERVICES	Required service definitions are missing
UCP_MISSING_SIGNING_KEYS	Order capability requires signing keys
UCP_SCHEMA_FETCH_FAILED	Could not fetch the remote schema

Next steps

• Citation Optimization — Optimize your product pages for AI citation
• LLMs.txt Generation — Help AI crawlers discover your content
• What is GEO? — Understand the broader framework for AI visibility