Promotions, Sync & Audit — MCP Tools
3 tools in the Promotions, Sync & Audit group of the Routebase MCP server.
get_audit_log
Read the API design audit log: who changed what, when, and whether it was a person or an API key. Filter by entityId for the history of one endpoint or schema — worth doing before changing something you did not write. Paginated; without filters it returns the whole organization's history newest first. Requires organization context.
Required scope: specs:read
| Parameter | Type | Required | Description |
|---|---|---|---|
specId |
string | No | Optional spec ID (GUID) to filter by |
entityId |
string | No | Optional entity ID (GUID) — the endpoint, schema or folder to trace |
entityType |
string | No | Optional entity type to filter by, e.g. 'endpoint', 'schema', 'folder' |
action |
string | No | Optional action to filter by, e.g. 'created', 'updated', 'deleted' |
actorUserId |
integer | No | Optional numeric user ID to filter by |
dateFrom |
string | No | Optional lower bound, ISO 8601 (e.g. '2026-07-01T00:00:00Z') |
dateTo |
string | No | Optional upper bound, ISO 8601 |
page |
integer | No (default 1) |
Page number, 1-based (default 1) |
pageSize |
integer | No (default 50) |
Entries per page (default 50, max 200) |
list_artifact_sync_reviews
List what in this project has fallen out of sync with the specs behind it — mocks, tests and monitors whose endpoint changed or disappeared. Worth reading after changing a draft: these are the follow-ups that change created. Requires project context.
Required scope: specs:read
No parameters.
list_promotions
List how versions of a spec reached their environments: which version, which environment, whether it was a rollback and whether it froze the version. get_environment_pins shows the current state; this is how it got there. Requires project context.
Required scope: specs:read
| Parameter | Type | Required | Description |
|---|---|---|---|
specId |
string | Yes | Public ID (GUID) of the API specification |
environmentId |
string | No | Optional environment ID (GUID) to filter by |
take |
integer | No (default 50) |
How many entries to return, newest first (default 50) |