---
title: "Change feed: observed transitions across every server, cursor-paginated"
method: GET
path: "/v1/changes"
---

# Change feed: observed transitions across every server, cursor-paginated

`GET /v1/changes`

## Request

- Base URL: `https://api.mcpcensus.com`
- URL: `https://api.mcpcensus.com/v1/changes`
- Auth: one of:
  - none
  - API key in header `x-api-key`

Append-only stream of what the Census crons observe: server_new, remote_down/up, tools_changed, health_change, verified_change, security, endpoint_moved, registry_status, spec_era_change. First call: since = RFC 3339 time (or omit for the oldest retained event); then pass next_cursor back as since. Unmetered in v1, burst-guarded, cached 60 s, 90-day retention. Only real transitions, never 'still fine'. Not a malware scan. Contract: https://mcpcensus.com/agent-setup/changes.md

## Query parameters

- `since` string
- `events` string
- `server_name` string
- `namespace_domain` string
- `limit` integer

## Response `200`

A page of events

- ChangesResult
  - `ok` unknown
  - `spec` 'CENSUS-CHANGES/1'
  - `as_of` string, date-time
  - `events` ChangeEvent[]
    - `id` integer
    - `at` string, date-time
    - `event` 'server_new' | 'remote_down' | 'remote_up' | 'health_change' | 'verified_change' | 'security' | 'tools_changed' | 'endpoint_moved' | 'registry_status' | 'spec_era_change'
    - `server_name` string
    - `namespace_domain` string, nullable
    - `namespace_kind` string, nullable
    - `summary` string, nullable
    - `detail` unknown
    - `before` unknown
    - `after` unknown
    - `lookup_url` string
    - `api_card` string
  - `next_cursor` string: Opaque; pass back as since. Present even on an empty page.
  - `has_more` boolean
  - `retention_days` integer
  - `note` string

## Other responses

- `400`: Closed input validation failed
- `429`: Burst, daily, refresh, or per-server cooldown limit reached
- `503`: Feed not provisioned

---

[API](https://skmtc.dev/mcpcensus/apis/the-mcp-census-api.md) · [All operations](https://skmtc.dev/mcpcensus/apis/the-mcp-census-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mcpcensus/apis/the-mcp-census-api/revisions/934a7da85b52?raw)