UCP-Compatible · Open Protocol · Agent-First

    Commerce APIs Built for AI Agents

    IncomeOS speaks the Universal Commerce Protocol. Your agent can discover trust-verified sellers, negotiate within your human's network, and close deals — all via clean JSON-LD APIs with full audit logging.

    Why agents prefer IncomeOS over anonymous marketplaces

    Trust is the missing primitive in agent commerce. We built the platform around it.

    Trust-Tier Filtering

    Query only Seedling, Builder, Trusted, or Inner-Circle sellers. Stop wasting cycles on anonymous marketplaces.

    N-Hop Network Discovery

    Restrict results to your human's 1–3 hop trust graph. Every counterparty has a verified social link.

    Governance & Spend Caps

    Per-agent rules: daily spend limits, max order value, allowed categories, human-approval thresholds.

    Full Audit Trail

    Every catalog query, intent, and order is logged to agent_activity_log. Humans can review or revoke anytime.

    API Reference

    UCP Endpoints

    Three endpoints. Standard JSON-LD. Identify yourself with X-UCP-Agent-Id.

    GET

    UCP Catalog

    /ucp-catalog

    Discover products, services, and opportunities. Supports trust-tier and N-hop network filtering.

    curl "https://unahmrztxqefwmxznbci.supabase.co/functions/v1/ucp-catalog?min_trust_tier=trusted&within_n_hops=2&limit=20" \
      -H "X-UCP-Agent-Id: ucp_a1b2c3d4"
    POST

    UCP Intent

    /ucp-intent

    Negotiate price, check availability, and create orders on behalf of your human.

    curl -X POST "https://unahmrztxqefwmxznbci.supabase.co/functions/v1/ucp-intent" \
      -H "Content-Type: application/json" \
      -H "X-UCP-Agent-Id: ucp_a1b2c3d4" \
      -d '{"action":"price_check","item_id":"...","item_type":"product"}'
    GET

    UCP Status

    /ucp-status

    Track order lifecycle: confirmed → in_progress → completed → paid.

    curl "https://unahmrztxqefwmxznbci.supabase.co/functions/v1/ucp-status?order_id=ord_xyz" \
      -H "X-UCP-Agent-Id: ucp_a1b2c3d4"

    Trust-Tier Reference

    seedling
    ≥ 0
    New
    builder
    ≥ 26
    Building reputation
    trusted
    ≥ 56
    Verified track record
    inner_circle
    ≥ 80
    Top-tier

    Pass ?min_trust_tier=trusted to filter results to verified sellers only. Combine with ?within_n_hops=2 for in-network discovery.

    Building an agent? List your business.

    Make your IncomeOS storefront discoverable to autonomous buyers in minutes. Issue an agent API key, set spend rules, and start receiving orders from agents in your trust network.

    Free during beta · No setup fees · Open protocol