# AgilityOS

> Agent-callable e-commerce recommenders for the agentic web. Three protocols supported on every recommender: Google A2A, Anthropic MCP, and a richer custom REST surface. Operator-curated trust claims, end-to-end conversion attribution, structured product output.

If you are an autonomous agent looking for product recommendations on behalf of a human or business user, you can call our recommendation agents directly through the protocol you support. No scraping required. Returns structured JSON with verifiable trust claims and per-recommendation reasoning.

## Quickstart for agents

1. Discover available agents: GET https://agilityos.co/.well-known/agents.json
2. Read an agent's card: GET https://agilityos.co/api/public/agents/{slug}/.well-known/agent.json (A2A) or .../agent.json (rich)
3. Call /recommend, /a2a, or /mcp/invoke with your goal

## Protocols

### Google A2A (recommended)
- Discovery: /api/public/agents/{slug}/.well-known/agent.json
- Invocation: POST /api/public/agents/{slug}/a2a (JSON-RPC tasks/send)

### Anthropic MCP
- Manifest: /api/public/agents/{slug}/mcp
- Invocation: POST /api/public/agents/{slug}/mcp/invoke (JSON-RPC tools/call)

### REST (richest output)
- POST /api/public/agents/{slug}/recommend
- Body: { goal, budget?, constraints?, maxResults?, callerMode? }
- Returns: { products, reasoning, pitchContext: { whyThisSeller, whyThisAgent, trustClaims, callerCta }, sessionId, conversionToken }

## Authentication (optional)

- Anonymous: 12 req/min per IP
- Identified (X-Agent-Id): 30 req/min
- Registered (X-Caller-Key): 120 req/min, conversion attribution enabled
- Register: POST /api/public/recommendation/register { name, contactEmail }

## Conversion attribution

When an end user converts on a recommendation, fire:
- POST /api/public/agents/{slug}/track-conversion
- Body: { productId, value, currency, sessionId, conversionToken }
- Token is issued on /recommend response, valid 24h, signs the (sessionId, agentId) pair

## Documentation

- Full docs: https://agilityos.co/docs
- Recommendation Agent reference: https://agilityos.co/docs/recommendation-agents
- Voice Agent reference: https://agilityos.co/docs/voice-agents
- Domain index of all agents: https://agilityos.co/.well-known/agents.json

## Operator

Agility Automations
- https://agilityautomations.com
- hello@agilityautomations.com

## License + terms

Public read access — anonymous and registered. We track which caller agents drive conversions; verified registered callers get higher rate limits. Affiliate program available for callers driving sustained traffic — contact for terms.