Quickstart

read -rs MOONBOUNCE_API_KEY && export MOONBOUNCE_API_KEY

export MOONBOUNCE_API_URL="${MOONBOUNCE_API_URL:-https://api.moonbounce.ai}"
curl -sS --fail-with-body "$MOONBOUNCE_API_URL/health"

cat > decision.json <<'EOF'
{
  "format": "moonbounce.spec/0",
  "meta": {
    "title": "Refund request",
    "owner": "support",
    "display": { "approve": { "text": "Auto-reply" }, "escalate": { "text": "Send to a person" } }
  },
  "guidance": "A support message from a customer. Answer from the message alone.",
  "nodes": {
    "asks_for_refund": { "type": "boolean", "prompt": "Does the customer ask for their money back?" },
    "is_angry": { "type": "boolean", "prompt": "Is the customer angry or threatening?" },
    "risk": { "type": "combine", "terms": [{ "node": "asks_for_refund" }, { "node": "is_angry" }] },
    "risk_calibrated": { "type": "calibrate", "node": "risk" }
  },
  "output": "risk_calibrated",
  "target": "The message needs a person to handle it."
}
EOF

curl -sS --fail-with-body -X POST "$MOONBOUNCE_API_URL/v1/specs/hash" \
  -H 'Content-Type: application/json' \
  -d "$(jq -n --slurpfile spec decision.json '{spec: $spec[0]}')" | jq -r .structure

EVALUATE_KEY=$(uuidgen)
EVALUATION=$(curl -sS --fail-with-body -X POST "$MOONBOUNCE_API_URL/v1/evaluate" \
  -H "Authorization: Bearer $MOONBOUNCE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $EVALUATE_KEY" \
  -d "$(jq -n --slurpfile spec decision.json '{
    decision_id: "quickstart.refund-request",
    spec: $spec[0],
    weights: "default",
    item_id: "ticket-1042",
    subject: [{type: "text", name: "message", text: "My order arrived broken. I want a refund, today."}],
    outcomes: {below: "approve", cuts: [{at: 0.5, outcome: "escalate"}]}
  }')")
echo "$EVALUATION" | jq '{id, outcome, score, nodes}'
EVALUATION_ID=$(echo "$EVALUATION" | jq -r .id)

{
  "id": "evl_01a17a7b-da6f-71a4-b3d0-f7b5bb80ade7",
  "status": "scored",
  "outcome": "escalate",
  "score": 0.81,
  "nodes": {
    "asks_for_refund": { "type": "boolean", "value": 0.97 },
    "is_angry": { "type": "boolean", "value": 0.65 },
    "risk": { "type": "combine", "value": 0.81, "contributions": { "asks_for_refund": 0.485, "is_angry": 0.325 } },
    "risk_calibrated": { "type": "calibrate", "value": 0.81, "calibrated": false }
  }
}

curl -sS --fail-with-body "$MOONBOUNCE_API_URL/v1/evaluations/$EVALUATION_ID" \
  -H "Authorization: Bearer $MOONBOUNCE_API_KEY" | jq '{id, outcome}'

FEEDBACK_KEY=$(uuidgen)
curl -sS --fail-with-body -X POST "$MOONBOUNCE_API_URL/v1/feedback" \
  -H "Authorization: Bearer $MOONBOUNCE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $FEEDBACK_KEY" \
  -d "$(jq -n --arg id "$EVALUATION_ID" '{
    about: {evaluation_id: $id},
    claims: [{kind: "outcome", value: "escalate"}],
    source: "owner",
    reason: "Broken on arrival: a person should handle it."
  }')" | jq '{id, evaluation_id}'

import { readFileSync } from "node:fs";

const base = process.env.MOONBOUNCE_API_URL ?? "https://api.moonbounce.ai";
const headers = {
  Authorization: `Bearer ${process.env.MOONBOUNCE_API_KEY}`,
  "Content-Type": "application/json",
};

// One Idempotency-Key per request: keep it, and pass the same one again to retry that request.
async function post(path: string, body: unknown, idempotencyKey: string) {
  const res = await fetch(`${base}${path}`, {
    method: "POST",
    headers: { ...headers, "Idempotency-Key": idempotencyKey },
    body: JSON.stringify(body),
  });
  const json = await res.json();
  if (!res.ok) throw new Error(`${res.status} ${json.error?.reason ?? json.error?.type}: ${json.error?.message}`);
  return json;
}

const evaluateKey = crypto.randomUUID();
const evaluation = await post(
  "/v1/evaluate",
  {
    decision_id: "quickstart.refund-request",
    spec: JSON.parse(readFileSync("decision.json", "utf8")),
    weights: "default",
    item_id: "ticket-1043",
    subject: [{ type: "text", name: "message", text: "Thanks, the replacement works fine." }],
    outcomes: { below: "approve", cuts: [{ at: 0.5, outcome: "escalate" }] },
  },
  evaluateKey,
);
console.log(evaluation.outcome, evaluation.score);

const feedbackKey = crypto.randomUUID();
const feedback = await post(
  "/v1/feedback",
  { about: { evaluation_id: evaluation.id }, claims: [{ kind: "outcome", value: "approve" }], source: "owner" },
  feedbackKey,
);
console.log(feedback.id);

{
  "mcpServers": {
    "moonbounce": {
      "type": "http",
      "url": "${MOONBOUNCE_API_URL:-https://api.moonbounce.ai}/mcp",
      "headers": { "Authorization": "Bearer ${MOONBOUNCE_API_KEY}" }
    }
  }
}

curl -sS --fail-with-body -X POST "$MOONBOUNCE_API_URL/mcp" \
  -H "Authorization: Bearer $MOONBOUNCE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | grep -o '"name":"evaluate"'