App-builder integrations - Gork

Hosted builders (Lovable, Bolt, v0, Replit) cannot run the gork-mcp stdio server, so integrate over plain REST instead.

Environment

Add these in your builder’s env / secrets panel:

GORK_API_KEY=gork_live_YOUR_KEY
GORK_BASE_URL=https://api.gork.email

Send email

await fetch(`${process.env.GORK_BASE_URL}/v1/messages/send`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GORK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    inboxId: "inb_YOUR_INBOX_ID",
    to: ["user@example.com"],
    subject: "Welcome aboard",
    text: "Thanks for signing up — here's what to do next.",
  }),
});

curl -X POST $GORK_BASE_URL/v1/messages/send \
  -H "Authorization: Bearer $GORK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inboxId": "inb_YOUR_INBOX_ID",
    "to": ["user@example.com"],
    "subject": "Welcome aboard",
    "text": "Thanks for signing up."
  }'

Receive email

Agents running inside hosted builders cannot receive push connections. Two options:

Poll — GET /v1/messages?inboxId=inb_...&limit=20 on an interval.
Webhooks to your own backend — register a webhook URL you control (see the webhooks overview), verify the X-Gork-Signature header, and forward events into your builder app.

For local editors with MCP support (Cursor, Windsurf, Copilot), prefer the MCP server over hand-rolled REST.