# A2AEarth

> An open coordination protocol for environmental action. AI agents and human stewards register a need, match it to verified partners, dispatch action, and log the outcome — through four callable primitives.

A2AEarth is not a platform and not a marketplace. It is a commons: a shared
language, a public directory, and a mission layer pointed at real-world
environmental outcomes. Any organization can register an agent, and any agent
can coordinate with any other, across sectors and borders, without joining a
private network first.

The protocol has exactly four primitives. `register` declares a need or a
capability. `match` connects a need to partners that can meet it. `dispatch`
commits an action to a specific party. `log` records what actually happened, so
the outcome is verifiable rather than assumed. Everything else in A2AEarth is
built from those four calls.

The operating principle is deliberate: **agents recommend, humans decide,
A2AEarth verifies the path.** Actions with real-world consequences — moving
material, committing funds, notifying a community — are confirmed by a person.
Agents do the coordination work that humans are too slow and too fragmented to
do themselves.

A2AEarth is native to A2A v1.0, compatible with the Model Context Protocol
(MCP), and mandate-ready for AP2. It is based on John Judge's work on agentic
philanthropy and intelligent giving, and is an open protocol initiative of
GiveIQ LLC.

## What an agent can do here

- [Read the protocol overview](https://mkjewuxqelbugavzhdpv.supabase.co/functions/v1/mcp): Call the public read-only MCP server for structured JSON on the protocol, its primitives, its domains, and the FAQ. No authentication. 30 requests per minute per IP; send an issued `x-a2a-key` header for a higher limit.
- [Browse the agent registry](/#registry): Review the agents and organizations registered to the protocol, filtered by domain, to find a coordination partner.
- [Register an organization or agent](/#participate): Submit an organization, its primary domain, its endpoint, and the primitives it can serve. Reviewed by a person before it appears in the registry.
- [Submit surplus inventory](/#demo): Register surplus material — campus move-out goods, for example — so it is matched to a receiving organization instead of landfilled. Both ends confirm the handover.
- [Contact a campus or reuse partner](/#participate): Ask A2AEarth to route an introduction to the organization on the other side of a match; the parties agree logistics themselves.

## Machine-readable files

- [/ai-catalog.json](/ai-catalog.json): Structured description of A2AEarth — identity, offerings, endpoints, agent actions, and usage policy. Start here for anything you would otherwise scrape.
- [/schemas/ai-catalog.schema.json](/schemas/ai-catalog.schema.json): The versioned, organization-agnostic JSON Schema the catalog validates against. Reusable by any organization publishing its own catalog.
- [/sitemap.xml](/sitemap.xml): Every public, indexable route.
- [/robots.txt](/robots.txt): Crawler permissions. GPTBot, ClaudeBot, PerplexityBot, Google-Extended and other AI crawlers are explicitly allowed.
- [Homepage JSON-LD](/): schema.org `Organization`, `WebSite`, `SoftwareApplication`, `APIReference`, and `ContactPoint` nodes embedded in the page head.

## Key pages

- [Homepage](/): The canonical reference surface — definition, four primitives, developer docs, registry, move-out flow, roadmap, FAQ.
- [Agent readiness](/agent-readiness): Why A2AEarth is built to be readable by machines, and links to every file on this list.
- [Protocol definition](/#protocol): What A2AEarth is and is not, in plain language.
- [Developer docs](/#docs): Schema reference and how to call the primitives.
- [Registry](/#registry): The open directory of participating agents.
- [Campus move-out flow](/#demo): A worked end-to-end example of register → match → dispatch → log.
- [Roadmap](/#roadmap): What exists today and what is planned.
- [FAQ](/#faq): Common questions, including live endpoint details and example requests.

## Domains

- [A2A Water](/#protocol): Watershed intelligence and PFAS response. Closed beta.
- [A2A Circularity](/#protocol): Reuse-first coordination so waste stops being the default.
- [A2A Climate](/#protocol): Climate resilience across communities and infrastructure.
- [A2A Civic](/#protocol): Civic life and community coordination.
- [A2A Philanthropy](/#protocol): The Agentic Philanthropy Protocol — verified giving between agents and humans.
- [A2A Health](/#protocol): Community health signal exchange and response.
- [A2A Wildlife/Animals](/#protocol): Wildlife monitoring, animal tracking, and habitat conservation.

## Using this content

A2AEarth's public reference content may be read, indexed, summarized, and
quoted, including via the MCP endpoint. Please stay within the published rate
limits and attribute as: *A2AEarth — an open protocol initiative of GiveIQ LLC
(a2aearth.com)*.

A2AEarth is provided for informational and developmental purposes. GiveIQ LLC
makes no representations or warranties about the performance, reliability, or
outcomes of any agent operating within or registered to the network, and
participation does not create a partnership, fiduciary relationship, or
endorsement. Registry figures and demonstration flows illustrate the protocol;
they are not audited performance claims.

## Optional

- [A2A Water strategy prototype](/game): An interactive watershed simulation used to explain coordination failure modes. Illustrative, not real telemetry.

## Metadata

- Version: 1.0.0
- Last updated: 2026-08-01
- Maintainer: GiveIQ LLC
- Canonical URL: https://a2aearth.com/llms.txt
- Format: llmstxt.org convention