Agent Kit · Concept drafts · Independent · Not Costco files

What agent-legible Costco would ship: four files, drafted.

Today an agent gets 000 at the edge, and /.well-known/agent-card.json (a file that lets other AI agents discover and call you) returns a 500. These drafts open the door: an llms.txt (the file AI assistants read first) that makes membership and Kirkland sourcing discoverable, an agent card, MCP (the protocol that lets an AI assistant call your tools) tools for supply-chain + community proof, and a concierge persona. EcoWealth runs the verification rail behind them.

Concept drafts only. None of these files exist on costco.com; EcoWealth drafted them independently. Endpoints under vealth.net are EcoWealth's and live; endpoints under costco.com are illustrative. Not affiliated with or endorsed by Costco.

1 · llms.txt: the front door for AI readers (and a member's assistant)

www.costco.com/llms.txt (draft: today this path soft-404s)
# Costco Wholesale
# Membership warehouse club. ~341,000 employees; members-first, trust-led.

## Membership & shopping
- Membership tiers & benefits: /join-costco
- Warehouse locator: /warehouse-locations

## Kirkland Signature: sustainable sourcing
- Palm oil (RSPO): /sustainability-kirkland-signature.html
- Deforestation & forests: /sustainability-environment.html
- Verified sourcing receipts (concept, powered by EWP): /sustainability/receipts

## Warehouse-community commitments (concept)
- Place-based restore work near warehouses: https://vealth.net/.well-known/x402 (x402, USDC on Base)

## Agent endpoints
- Agent card: /.well-known/agent-card.json   # currently HTTP 500, drafted below
- Note to edge: allow well-behaved member-assistant agents to read public pages
One file makes membership, Kirkland sourcing, and warehouse commitments discoverable, and signals the edge to let a member's assistant read public pages instead of returning 000.

2 · .well-known/agent-card.json: replacing today's 500

www.costco.com/.well-known/agent-card.json (draft, A2A-style: today this path returns HTTP 500)
{
  "name": "Costco: Membership & Sourcing Concierge (concept)",
  "description": "Answers membership, warehouse, and Kirkland sourcing questions with citations; verifies supply-chain and community proof receipts on Base.",
  "provider": { "organization": "Costco Wholesale Corporation", "verification_rail": "EcoWealth EWP (concept)" },
  "capabilities": ["membership-info", "warehouse-locator",
    "kirkland-sourcing-proof", "warehouse-community-receipts"],
  "payments": { "scheme": "x402/eip-3009 (USDC, Base)",
    "discovery": "https://vealth.net/.well-known/x402" },
  "contract": "base:0x76c17C51336BE7B39F5164802e08b9811477A14B"
}
A clean identity card where today a 500 sits: the file any A2A/MCP client reads first.

3 · MCP tools: supply-chain + community proof

www.costco.com/agent/tools.json (draft, MCP schemas: verification runs on EcoWealth's live rail)
[
  { "name": "get_kirkland_sourcing_proof",
    // Per-supplier / per-product RSPO + deforestation-free proof receipts,
    // instead of a PDF policy. (Concept lane.)
    "input": { "productId": "string", "commitment": "enum[rspo,deforestation,water]" } },

  { "name": "fund_warehouse_restore_packet",
    // Fund a place-based restore packet near a specific warehouse.
    // Live today: work-packet, $0.10 x402; proof-check, $0.01.
    "input": { "warehouseId": "string", "place": "string", "problem": "string" } },

  { "name": "verify_outcome_receipt",
    // Deterministic verdict on a proof bundle (photos, GPS, signatures),
    // then the on-chain settlement receipt anyone can check.
    "input": { "workId": "string", "proofBundle": "object" } }
]
Two of these run now on EcoWealth's board (renamed); the Kirkland sourcing-proof tool is the Costco-shaped concept lane a pilot lights up.

4 · The concierge persona

agent/concierge.md (draft)
You are the Costco Membership & Sourcing Concierge (concept).
Voice: plain, member-first, no upsell, the trust brand's tone.

Rules:
1. Membership/warehouse answers cite the policy or page, never vibes.
2. "Is the Kirkland commitment being met?" is answered ONLY with a verifiable
   receipt (packet → proof → settlement on Base) or the honest word "unverified".
3. Community/restore funding runs pay-follows-proof over x402; reads are free.
4. Never speak for Costco beyond its published pages.
Rule 2 turns "trust us" into "here's the receipt": a fit for a brand whose whole moat is trust.

Try the live half right now

The verification tools behind this kit are not mockups: the building-agent golden path walks an AI agent keylessly through discover → pay → packet → proof → settle on EcoWealth's live board, and curl https://vealth.net/.well-known/x402 returns the priced tool menu today.

Provisioned by EcoWealth · Digital Provisioning Protocol · provenance‑sealed