The four files that make the environment surface legible & actionable

Drop-in Agent Kit: the same class of file Apple already ships.

Prototype files in the exact shape A2A and the llms.txt convention expect: the agent-facing sibling of the security.txt and apple-app-site-association Apple already maintains. They make Apple's environment story answerable to any assistant and hand it a funded, proof-verified Restore destination. Endpoints are illustrative; the EWP contract and x402 lanes are live and verifiable.

Concept files · illustrative endpoints · not Apple-published

1 · llms.txt: the map an assistant reads first

Apple's environmental commitments, exposed for assistants, with a per-project proof destination.

apple.com/environment/llms.txtconcept · text/markdown

# Apple Environment: agent index (concept)

> Apple's climate commitments, exposed for assistants,
> with per-project on-chain proof for restoration work.

## Commitments (queryable)
- Apple 2030: carbon neutral across the global footprint
- Restore Fund: forestry & ecosystem carbon removal
- 2026 Environmental Progress Report

## Per-project proof: via EcoWealth Work Protocol (partner)
- Restore projects: https://vealth.net/labor/stats
- Machine payment (x402): https://vealth.net/.well-known/x402
- Contract (Base, verified): 0x76c17C51336BE7B39F5164802e08b9811477A14B
- Ladders: Build (LBC) · Grow & Cook (Michelin) · Restore (UN SDGs)

2 · agent-card.json: A2A discovery

The file that's a 404 today: the agent-facing sibling of Apple's existing well-known files.

/.well-known/agent-card.jsonconcept · a2a/1.0

{
  "protocolVersion": "a2a/1.0",
  "name": "Apple Environment Agent",
  "description": "Read a product's environmental sheet; verify and fund per-project restoration.",
  "skills": [
    { "id": "get_product_environment", "tags": ["product","footprint"] },
    { "id": "get_restore_project", "tags": ["restore","onchain"] },
    { "id": "fund_restore_packet", "tags": ["pay","x402"] }
  ],
  "partners": [{ "name": "EcoWealth Work Protocol", "url": "https://vealth.net" }],
  "payment": { "scheme": "x402", "endpoint": "https://vealth.net/.well-known/x402" }
}

3 · MCP tool schemas: what an agent can call

The verbs. Each returns a structured object; the funding + settling ones end in an on-chain receipt.

tools.jsonconcept · MCP

[
  { "name": "get_product_environment",
    "description": "Return a product's footprint + recycled content as structured data (AGEC-shaped).",
    "input": { "sku": "string" } },

  { "name": "get_restore_project",
    "description": "Return a Restore project + its on-chain settlement status.",
    "input": { "region": "string" }, "returns": "onchain_receipt" },

  { "name": "fund_restore_packet",
    "description": "Fund one Restore work-packet keyless over x402 ($0.10).",
    "input": { "projectId": "string" }, "returns": "payment_receipt" },

  { "name": "submit_proof",
    "description": "Attach photo + GPS + method to a claimed packet.",
    "input": { "packetId": "string", "proof": "object" } },

  { "name": "settle_and_receipt",
    "description": "Verify proof, settle on Base, return the permanent tCO2e receipt.",
    "returns": "onchain_receipt" }
]

4 · Concierge persona: how the agent should speak

"Terra": Apple Environment concierge (concept)

Voice: calm, exact, understated, Apple's own register. Grounds every claim in a real commitment or a per-project receipt; never inflates.

Job: turn "how green is this?" and "I want to help" into structured answers and a funded, verifiable restoration.

Answer footprint questions from get_product_environment, with the source (the AGEC-shaped sheet).

When a customer wants to act, verify a Restore project on-chain, then fund_restore_packet keyless over x402.

End every action with the per-project on-chain receipt: a live complement to the annual report, not a replacement.

Distinguish "live today" (contract, workId 14) from "pilot" (external settlement): the truthbox at the top of every page is the standing rule.

Four files. Apple's own file habits. A live restoration destination on the other end.

None of this touches Apple's systems. It makes the environment surface legible over A2A and points agents at funded, proof-verified restoration that settles on Base. Start with one $0.10 call: provable for a dime.

Back to the overview →