How to Configure a Standard ucp.json for WordPress & WooCommerce (2026 Guide)

1. What is ucp.json?

The ucp.json file is the manifest for the Universal Commerce Protocol. Think of it as the "Source of Truth" for machine-to-machine commerce.

It functions similarly to:

• sitemap.xml for Google Search.
• robots.txt for Web Crawlers.
• ucp.json is specifically designed for AI Agents (LLMs, Autonomous Buyers).

2. File Location & Reachability

For an AI Agent to discover your store's protocol, the file must be accessible at one of the following root paths:

• https://yourdomain.com/.well-known/ucp.json (Recommended)
• https://yourdomain.com/ucp.json

3. The 2026 Standard ucp.json Structure

Here is a compliant template for a modern WooCommerce store:

JSON

{
  "protocol": "UCP/1.0",
  "store": {
    "name": "WooUCP Global Store",
    "url": "https://wooucp.com",
    "currency": "USD",
    "country": "US"
  },
  "endpoints": {
    "products": "/wp-json/wc/v3/products",
    "inventory": "/wp-json/wc/v3/products/stock",
    "checkout": "/wp-json/ucp/v1/agent-checkout"
  },
  "capabilities": {
    "discovery": true,
    "price_sync": true,
    "agent_checkout": true,
    "negotiation": false
  },
  "security": {
    "auth_method": "AP2-Signature",
    "verification_url": "https://wooucp.com/.well-known/ap2-pubkey"
  }
}

4. Mandatory Fields for 2026 Compliance

To ensure your store isn't rejected by AI Reasoning Engines, these fields are required:

• protocol: Must specify UCP/1.0 or higher.
• store.currency: Must follow ISO 4217 (e.g., USD, VND, EUR).
• endpoints.products: The direct API path where AI can fetch product attributes without HTML scraping.
• capabilities: A boolean declaration of what an AI Agent can do (e.g., Can it buy? Can it negotiate?).
• security: Defines the handshake method for secure transactions.

5. Common Configuration Pitfalls

Avoid these mistakes to maintain your "AI-Friendly" status:

• ❌ Incorrect Character Encoding: Always use UTF-8.
• ❌ Permission Denied: Ensure the file isn't blocked by your Firewall or security plugins (like Wordfence).
• ❌ Static Data: Providing an API endpoint that doesn't update inventory in real-time leads to "AI Cart Abandonment."
• ❌ Auth Requirements: Discovery endpoints must be publicly readable.

6. How WooUCP Automates the Process

Manually maintaining a JSON file for every store update is inefficient. WooUCP automates the entire lifecycle:

• Dynamic Generation: Automatically creates and updates ucp.json based on your WooCommerce settings.
• Schema Validation: Ensures your API endpoints meet the latest UCP standards.
• Agent Tracking: Monitors which AI Agents (GPTBot, ClaudeBot, etc.) are accessing your manifest.
• AP2 Integration: Bridges the ucp.json capabilities with actual payment execution.

Conclusion

The ucp.json file is the key that unlocks your store's door to the AI Economy. Proper configuration ensures that AI Agents don't just "visit" your site—they understand, trust, and transact with you.