Public AX examples

Estimate → run → wait → receipt.

Machine loop for agents and scripts. No trade-secret prompts. Provenance proves integrity, not factual truth.

1 · Estimate (free)

Know the debit before you spend

Shell

export YSAERE_API_KEY=ysa_prod_YOUR_KEY
curl -sS -X POST https://api.ysaere.com/v1/intel/estimate \
  -H "Authorization: Bearer $YSAERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endpoint":"angel-report"}'

MCP: estimate_credits with {"tool":"angel_intelligence"}.

2 · Run + wait

Angel (50 cr) happy path

Shell

curl -sS -X POST https://api.ysaere.com/v1/intel/angel-report \
  -H "Authorization: Bearer $YSAERE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: angel-$(date +%s)" \
  -d '{"target":"Acme AI (pre-seed)"}'
# → data.run_id — poll GET /v1/reports/{run_id}
# MCP: wait_for_report {"report_id":"…","timeout_seconds":90}

CI: POST /v1/intel/ci-report (100 cr). On HTTP 402 read required, balance, topup_url.

3 · Push instead of poll (REST)

Webhooks for run complete

MCP hosts usually poll with wait_for_report. Scripts and backends can register a webhook so completion is pushed.

Shell

curl -sS -X POST https://api.ysaere.com/v1/webhooks \
  -H "Authorization: Bearer $YSAERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/hooks/ysaere","events":["report.completed"]}'
# Returns signing secret once — verify HMAC on delivery.
# Also: report.failed · run.completed (alias) · *
# SSRF-safe URLs only (no localhost / private IPs).

Manage deliveries: GET /v1/webhooks/{id}/deliveries. Full schema in OpenAPI.

4 · Skill pack

Teach Cursor / Claude the loop

Prefer check_balance then estimate_credits, then Angel (50) or CI (100). Start a run → wait_for_report until completed. Call verify_provenance before trusting the chain. Integrity ≠ verified fact.

Repo copy: examples/AGENT-SKILL.md.

MCP setup API door