Inventory for Agents

Connecting Merchants to AI Agents · The Universal Commerce Standard

$IFAComing to Pump.fun

Builder phase · MVP

BLOCK: 84,230,119

Jump to Section

Documentation

Inventory for Agents

The protocol converting Shopify & WooCommerce catalogs into agent-readable streams.

1. What is IFA?

Inventory for Agents (IFA) turns your Shopify or WooCommerce catalog into an agent-readable inventory feed and lets AI agents pay via x402 (USDC on Base, initially).

Install Plugin

Sync Inventory

Agent Discovery

Auto Checkout

Launch Scope (v0)

Platform: Shopify & WooCommerce
Inventory: Retail (Physical & Digital)
Rail: x402 + USDC on Base

2. Core Concepts

Merchant

Store owner installing the IFA plugin. Controls visibility.

Inventory Item

Normalized JSON record of a product/variant, optimized for LLM context.

Agent (MCP)

AI that searches catalog, builds carts, and triggers checkout.

Checkout Flow

HTTP-based crypto handshake. 402 Payment Required -> Verification -> Order.

3. Architecture

Plugin Installation

Grants IFA read access to products & write access to orders.

Backend Sync

IFA periodically transforms catalog into Agent-Ready JSON and exposes it via MCP.

Agent Checkout

Agent calls ifa.checkout_cart. IFA handles payment & injects order into store.

4. Inventory JSON — Retail v0

This is the schema agents "see". Our plugin maps your existing products into this shape automatically.

json

{
  "id": "sku-tee-black-m",
  "merchant_id": "shopify-12345",
  "inventory_type": "retail",
  "title": "Black Logo T-Shirt · Size M",
  "tags": ["tshirt", "cotton", "unisex"],
  "pricing": {
    "amount": 29.0,
    "currency": "EUR"
  },
  "availability": {
    "live": true,
    "stock": 42
  },
  "agent_metadata": {
    "summary": "Basic unisex black tee...",
    "usage_examples": ["Add 1 to cart..."]
  }
}

5. Platform Plugins

Shopify

Scopes: read_products, write_orders
Sync: Automatic on install + periodic refresh
Orders: Created with 'ifa_payment' gateway
No theme edits required

WooCommerce

Keys: REST API R/W
Sync: Fetches published products
Orders: Standard Woo Order API
Status set to 'Processing' on payment

6. Agent Interaction

Typical flow for an MCP-enabled agent:

ifa.search_inventory(query, filters)

Returns list of matched InventoryItems.

ifa.get_item(id)

Get full details including metadata.

ifa.create_cart(items[])

Initialize a cart session.

ifa.checkout_cart(id, address)

Triggers payment flow. Returns order_id on success.

7. Catalog Optimization

Merchant Checklist

✓Titles: Include key attributes (e.g. "Size M", "Unlimited Data").
✓Tags: Use material & use-case tags for filtering.
✓Stock: Keep platform inventory accurate.
✓Metadata: Fill out "Agent Summary" in dashboard.

8. Roadmap

Phase 1 (Now)

E-Commerce Retail

Shopify/Woo + Physical Goods

Phase 2

Bookings

Hospitality, Events, Travel

Phase 3

Compute

Digital Resource Offers