- Reference
- MCP tools reference
Reference
MCP tools reference
The tools the production MCP server lists for alpha work, what each needs, and the operations it keeps from agents.
The server is at https://api.greatwait.dev/mcp. A
connection lists only the tools its scopes allow. The MCP quickstart
connects a client.
Tools
| Tool | What it does | Scopes | Changes something | Environments |
|---|---|---|---|---|
exports_create | Create a data export | schedules:read, endpoints:read | yes | test, live |
exports_read | Read a data export | schedules:read, endpoints:read | no | test, live |
exports_cancel | Cancel a data export | schedules:read, endpoints:read | yes | test, live |
endpoints_list | List callback endpoints | endpoints:read | no | test, live |
endpoints_read | Read a callback endpoint | endpoints:read | no | test, live |
endpoints_update | Update a callback endpoint | endpoints:write | yes | test, live |
endpoints_disable | Disable a callback endpoint | endpoints:write | yes | test, live |
endpoints_enable | Enable a disabled callback endpoint | endpoints:write | yes | test, live |
testsinks_create | Create a test sink | endpoints:write | yes | test |
testsinks_list | List test sinks | endpoints:read | no | test |
testsinks_read | Read a test sink | endpoints:read | no | test |
testsinks_configure | Set a test sink behavior program | endpoints:write | yes | test |
sinkdeliveries_list | List test sink deliveries | endpoints:read | no | test |
testsinks_delete | Delete a test sink | endpoints:write | yes | test |
credentials_list | List API credentials | credentials:read | no | test, live |
projects_rename | Rename a project | projects:write | yes | test, live |
projects_archive | Archive or restore a project | projects:administer | yes | test, live |
projects_delete | Delete an archived project | projects:administer | yes | test, live |
credentials_rotate | Rotate an API credential | credentials:write | yes | test, live |
credentials_revoke | Revoke an API credential | credentials:write | yes | test, live |
schedules_create | Create a schedule | schedules:write | yes | test, live |
schedules_read | Read a schedule | schedules:read | no | test, live |
schedules_list | List schedules | schedules:read | no | test, live |
forecast_read | Forecast upcoming occurrences | forecast:read | no | test, live |
usage_read | Read terminal occurrence volume by day | usage:read | no | test, live |
timing_summary | Read rolling delivery timing | usage:read | no | test, live |
occurrences_list | List retained occurrences | occurrences:read | no | test, live |
executions_list | List project executions | occurrences:read | no | test, live |
occurrences_read | Read an occurrence | occurrences:read | no | test, live |
attempts_list | List delivery attempts | occurrences:read | no | test, live |
attempts_read | Read a delivery attempt | occurrences:read | no | test, live |
occurrences_redeliver | Redeliver an occurrence | occurrences:redeliver | yes | test, live |
schedules_replace | Replace a schedule | schedules:write | yes | test, live |
schedules_pause | Pause a schedule | schedules:write | yes | test, live |
schedules_resume | Resume a schedule | schedules:write | yes | test, live |
schedules_cancel | Cancel a schedule | schedules:write | yes | test, live |
schedules_archive | Archive a schedule | schedules:write | yes | test, live |
Resources
| Resource | What it is |
|---|---|
greatwait://meta/version | Read the deployed version |
greatwait://meta/scaffold | Read the workspace scaffold |
greatwait://context | Read this credential’s authority |
Withheld from agents
These operations are served over HTTP and are deliberately not tools.
exports.part — A file part may contain customer payload plaintext; MCP exposes export metadata but never raw export content.
endpoints.create — Creation returns a one-time endpoint signing secret, and MCP has no negotiated secure-result channel that can keep it out of ordinary tool history.
endpoints.rotateSigningKey — Rotation returns a one-time endpoint signing secret, and MCP has no negotiated secure-result channel that can keep it out of ordinary tool history.
endpoints.acknowledgeSigningKeyRotation — This is a human assertion about a server outside GreatWait; an agent cannot observe that the server has accepted the new secret.
endpoints.revealSigningSecret — The response is an endpoint signing secret, which MCP has no secure-result channel for — and the route accepts only a signed-in member, which MCP never carries.
sinkdeliveries.read — The only operation that returns a delivered callback body. An agent handed it would put customer payload into ordinary tool history, which is the disclosure the narrow exception was written to avoid.
credentials.create — Issuance is authenticated by a signed-in member. MCP carries API credentials and OAuth tokens, and POST /v1/credentials refuses both.
credentials.connection — A signed-in member checking a key whose secret is still on screen. MCP carries API credentials and OAuth tokens, neither of which holds a transient secret or a session to bind one to.
projects.list — Enumerating an organization’s projects is a signed-in member’s question. MCP carries API credentials and OAuth tokens, whose authority already is one project, and this operation accepts neither.
projects.create — Creating a project is a signed-in member’s act. MCP carries API credentials and OAuth tokens, whose authority already is one project — so this operation accepts neither, and an agent that somehow created one could not act in it.
grants.list — A member’s own connected applications. MCP carries API credentials and OAuth tokens, and an application holding a grant must not be able to enumerate its rivals — still less disconnect them — so this operation accepts neither.
grants.revoke — Disconnecting an application is the member’s own act. MCP carries API credentials and OAuth tokens, and an application able to disconnect a grant could disconnect the ones belonging to every other application the member has connected.
forecast.windows — A transitional shape for the autoscaler migration, withdrawn after its cutover. forecast.read is the same data in the shape this product publishes, and it is the tool an agent should reach for.