Connect GitHub

Reviews are driven by GitHub, so the GitHub App installation is the one piece of setup with no API substitute. Install it on the owner (org or user), choose the repositories IonWarp may read, and each becomes a project.

From the API, a project is one call: the repository's full name, the installation id the app gave you, and setup: true so repository setup runs in the same request. The answer carries project.id and setup.task — the task to poll. This is the first step of the API quickstart, rendered from the declaration there.

Over MCP, discover what the installation can see with github_installations_list and github_repos_list, then pass the chosen repository into projects_create with the same repository and setup fields.

Bootstrap seeds an honestly empty scorecard. The ai-readiness scorecard appears immediately in its PENDING shape — nothing has been scanned yet, because the scan is on demand. A scorecard that showed a score before anything was measured would be a number with no evidence behind it, which is worse than a blank one.

List scorecards — GET /api/v1/scorecards

curl "https://ionwarp.com/api/v1/scorecards?status=not_started" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_acme"

How do our scorecards look right now?

data_query {
  "collection": "scorecards",
  "where": {
    "status": "not_started"
  }
}

{
  "object": "list",
  "data": [
    {
      "object": "scorecard",
      "id": "obj_123",
      "name": "Agentic Readiness",
      "status": "ready",
      "lifespan": "persistent",
      "trigger": "repo_connected",
      "summary": "IonWarp scanned acme/api and found 9 readiness actions.",
      "created_at": "2026-07-25T12:00:00.000Z",
      "updated_at": "2026-07-25T12:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Read what setup created with the setup projection — status, the checks it passed, and created (the ids it wrote per collection) — and confirm pull requests are syncing with the list on Repositories & PRs.

Next: Your First Review.