Prodigy Agent Ready · invoke layer

Make Grok call Aerís

Same APIs as ChatGPT Actions. Plain grok.com browse often discovers the POST but cannot send it. Invoke needs tools or a host with HTTP.

Shared backend (already live)

• Board: GET /api/agent/coffees.php
• Ask: POST /api/agent/message.php
• OpenAPI: /openapi.json
• MCP-style bridge: /api/agent/mcp.php

A. Hermes (Grok with tools) — already can

Oakmont Hermes sessions run Grok with terminal/HTTP. No Custom-GPT step. Prompt:

Dogfood Aerís ask_roastery:
1. GET coffees.php
2. POST message.php Brazil ETA + my email
3. Show queued id — don’t invent dates

Or MCP bridge:

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-Hermes"}}}'

B. Consumer grok.com

If the chat only has browse/read: same wall as plain ChatGPT browse.

Workarounds:

1. Use a Grok mode with code execution / computer use that can curl POST.
2. Paste Project-style instructions + OpenAPI and require it to output the exact curl — you run once (weak UX).
3. Prefer Hermes or xAI API tools (C) for real invoke.

C. xAI API — function calling

In your app, register tools:

• list_coffees → GET coffees.php
• ask_roastery → POST message.php or mcp.php tools/call
• get_business → GET /.well-known/prodigy.json

System prompt (short):

Aerís Roasting Co helper.
Call list_coffees before stock claims.
Missing lots (Brazil ETA) → ask_roastery only — never invent dates.
Collect email when possible. No agent checkout. Not Aerís Signature.

Test prompt

When is your Brazil coffee expected to be available?
My email is you@example.com

Expect tool trail → queued_for_humans + id.

Agent brief · ChatGPT · Claude · Markdown