GET /api/mcp/endpoint

Internal loopback-only HTTP contract used by the native MCP service. External callers cannot call this path at the public API host; they use the observations tool through tools/call on /api/mcp. Broker identity, attribution, audit and ticket policy remain authoritative.

GET/api/mcp/endpoint

Authorization

AuthorizationBearer token · headerrequired

Query parameters

agent_idstringrequired

min length 1 · max length 128

minutesinteger

min 5 · max 10080

limitinteger

min 1 · max 500

Header parameters

X-StratifyIQ-Reasonstringrequired

min length 3 · max length 500

X-StratifyIQ-Ticket-Numberstring

min length 1 · max length 100 · matches ^[A-Za-z0-9][A-Za-z0-9._:/#-]{0,99}$

X-StratifyIQ-Ticket-Systemstring

Required together with ticket number when ticket attribution is supplied.

Responses

200

Authorized read result

endpointDashboardEndpointrequired

Show properties

client_namestring | nullrequired

Show properties

Any of:

string

string

null

null

hostnamestringrequired

idstringrequired

last_heartbeatstring<date-time> | nullrequired

Show properties

Any of:

string<date-time>

string<date-time>

null

null

osstringrequired

evaluated_atstring<date-time>required

expires_atstring<date-time> | nullrequired

Show properties

Any of:

string<date-time>

string<date-time>

null

null

findingsDashboardFinding[] | nullrequired

Show properties

Any of:

DashboardFinding[]

Array of DashboardFinding

detailstringrequired

labelstringrequired

scopestringrequired

statusstringrequired

null

null

historyDashboardSample[] | nullrequired

Show properties

Any of:

DashboardSample[]

Array of DashboardSample

cpunumber | nullrequired

Show properties

Any of:

number

number

null

null

disknumber | nullrequired

Show properties

Any of:

number

number

null

null

memorynumber | nullrequired

Show properties

Any of:

number

number

null

null

observed_atstring<date-time>required

null

null

metricsDashboardMetric[] | nullrequired

Show properties

Any of:

DashboardMetric[]

Array of DashboardMetric

detailstringrequired

keystringrequired

labelstringrequired

statusstringrequired

valuenumber | nullrequired

Show properties

Any of:

number

number

null

null

null

null

observed_atstring<date-time> | nullrequired

Show properties

Any of:

string<date-time>

string<date-time>

null

null

policy_descriptionstringrequired

schemastringrequired

statusstringrequired

window_minutesintegerrequired

default

Authorization, attribution, provider or transport failure. Never healthy empty data.

string

Response

{
  "endpoint": {
    "client_name": "string",
    "hostname": "string",
    "id": "string",
    "last_heartbeat": "2019-08-24T14:15:22Z",
    "os": "string"
  },
  "evaluated_at": "2019-08-24T14:15:22Z",
  "expires_at": "2019-08-24T14:15:22Z",
  "findings": [
    {
      "detail": "string",
      "label": "string",
      "scope": "string",
      "status": "string"
    }
  ],
  "history": [
    {
      "cpu": 0,
      "disk": 0,
      "memory": 0,
      "observed_at": "2019-08-24T14:15:22Z"
    }
  ],
  "metrics": [
    {
      "detail": "string",
      "key": "string",
      "label": "string",
      "status": "string",
      "value": 0
    }
  ],
  "observed_at": "2019-08-24T14:15:22Z",
  "policy_description": "string",
  "schema": "string",
  "status": "string",
  "window_minutes": 0
}

"string"