---
title: "Deterministic 'am I set up?' probe"
method: GET
path: "/api/agent/setup-check"
tags: ["auth"]
---

# Deterministic 'am I set up?' probe

`GET /api/agent/setup-check`

## Request

- Base URL: `https://www.immersivecommons.com`
- URL: `https://www.immersivecommons.com/api/agent/setup-check`
- Auth: one of:
  - none
  - HTTP bearer

Optional Bearer. Always 200. With a valid token, returns `ready: true` plus scopes + the MCP install recipe; without (or with a bad token), returns `ready: false` + `missing` + `next_actions`. The verdict is the body, not the HTTP status.

## Response `200`

A setup checklist (ready true/false).

- SetupCheckResponse: ready:true carries checks{scopes,member_id,...}+mcp; ready:false carries missing[]+next_actions[]+mcp.
  - `ready` boolean, required
  - `checks` object
  - `missing` string[]
  - `next_actions` object[]
  - `mcp` object

---

[API](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api.md) · [All operations](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/revisions/be67c1f67c27?raw)