# Grok · Aerís ask_roastery

Plain grok.com browse can **discover** Aerís APIs; invoke needs tools (Hermes, code exec, or xAI API functions).

## Live endpoints
- `GET https://www.aerisroasting.com/api/agent/coffees.php`
- `POST https://www.aerisroasting.com/api/agent/message.php`
- OpenAPI: https://www.aerisroasting.com/openapi.json
- MCP HTTP bridge: https://www.aerisroasting.com/api/agent/mcp.php
- Setup page: https://www.aerisroasting.com/agent/grok/

## Hermes (recommended dogfood)
Grok-with-tools can curl the bridge directly — no Custom GPT step.

## xAI API tools
Register `list_coffees`, `ask_roastery`, `get_business`; implement via REST or mcp.php.

## Bridge example
```bash
curl -sS -X POST https://www.aerisroasting.com/api/agent/mcp.php \
  -H 'content-type: application/json' \
  -d '{"method":"tools/call","params":{"name":"ask_roastery","arguments":{"message":"When is Brazil expected?","lot":"Brazil","email":"you@example.com","agent":"Grok"}}}'
```