# a2ahello

> a2ahello makes a business agent-ready and agent-native in one place: generated discovery files, a hosted agent and the business's tools over A2A 1.0 and MCP, and quotes, holds, and orders under a policy the business sets. A free readiness scan shows what agents can read on a website today.

## Public API

- POST https://a2ahello.com/api/scans with JSON {"url": "https://example.com"}: starts a scan (rate limited per IP). Returns {id, status, report_url}; report_url is /r/{report_token}.
- GET https://a2ahello.com/api/scans/{id}?token={report_token}: scan status, score, and summary.
- GET https://a2ahello.com/api/scans/{id}/findings?token={report_token}: findings with evidence.
- GET https://a2ahello.com/r/{report_token}: the report page (private, not indexed).
- GET https://a2ahello.com/health and https://a2ahello.com/status: service health; status adds the scan queue depth.
- [Offer feed format a2ahello-offers/1](https://a2ahello.com/docs/feed): JSON or CSV, used to connect a business's data.

## Tenant endpoints

Each business on a2ahello has its own endpoints, exposing only the tools it has published (writes need a key or OAuth token and the business's agent policy):

- MCP: https://a2ahello.com/t/{slug}/mcp
- A2A agent card: https://a2ahello.com/t/{slug}/a2a/agent-card.json
- One connection to every opted-in business: https://a2ahello.com/mcp (find_business, then tools by tenant_id)
- OAuth 2.0 metadata: https://a2ahello.com/.well-known/oauth-authorization-server

## Agent directory

- [Agent directory](https://a2ahello.com/agents): the business agents hosted on a2ahello that chose to be listed, with their cards
- [Machine index](https://a2ahello.com/agents.json): JSON array of {name, description, card_url, a2a_url, skills, updated_at}
- [Directory agent card](https://a2ahello.com/.well-known/agent-card.json): A2A 1.0 agent at https://a2ahello.com/t/a2ahello/a2a with one read-only skill, find_agents (plain text or {"skill": "find_agents", "arguments": {"query": "...", "industry": "travel"}})

## Pages

- [Connect any agent](https://a2ahello.com/connectors): the MCP endpoint, key or OAuth, and the config for Muse, ChatGPT, Grok, Gemini, Copilot, Claude, OpenClaw and Hermes
- [Scanner](https://a2ahello.com/scanner): crawler user agent, robots.txt behavior, how to block it
- [Privacy](https://a2ahello.com/privacy)
- [Terms](https://a2ahello.com/terms)
- [Support](https://a2ahello.com/support): help, security contact, incident commitment