{"server":"google-colab","version":"1.0.0","description":"Cloudflare Edge Worker & Google Colab GPU / Media RAG Toolchain","protocolVersion":"2024-11-05","endpoints":{"mcp":"https://colab.suggestions.cc/mcp/colab","sse":"https://colab.suggestions.cc/sse","messages":"https://colab.suggestions.cc/mcp/messages","openapiActions":"https://colab.suggestions.cc/openapi.json","openapiActionsYaml":"https://colab.suggestions.cc/openapi.yaml","openapiFull":"https://colab.suggestions.cc/openapi-full.json","openapiFullYaml":"https://colab.suggestions.cc/openapi-full.yaml","actionsExecute":"https://colab.suggestions.cc/api/actions/execute","actionsQuery":"https://colab.suggestions.cc/api/actions/query","prompt":"https://colab.suggestions.cc/prompt","llmsTxt":"https://colab.suggestions.cc/llms.txt","privacy":"https://colab.suggestions.cc/privacy","rootInfo":"https://colab.suggestions.cc/root.json","connectors":"https://colab.suggestions.cc/connectors"},"connectors":{"chatgpt":"https://colab.suggestions.cc/connectors/chatgpt","spark":"https://colab.suggestions.cc/connectors/spark","grok":"https://colab.suggestions.cc/connectors/grok","generic":"https://colab.suggestions.cc/connectors/generic"},"toolsCount":38,"tools":[{"name":"drive_search","description":"Search files and folders in the authenticated user's Google Drive by filename or full-text query. Operates strictly with caller's delegated OAuth token.","parameters":["query","pageSize","mimeType"],"required":["query"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/drive_search"},{"name":"drive_list_files","description":"List files and folders in a specific Google Drive folder (or \"root\") of the authenticated user. Operates strictly with caller's delegated OAuth token.","parameters":["folderId","pageSize"],"required":[],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/drive_list_files"},{"name":"drive_get_file","description":"Retrieve file metadata and/or download content (Google Docs/Sheets/plain text/JSON/code) from the authenticated user's Google Drive.","parameters":["fileId","downloadContent"],"required":["fileId"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/drive_get_file"},{"name":"drive_upload_file","description":"Create or update a text, markdown, JSON, or notebook file directly in the authenticated user's Google Drive.","parameters":["name","content","mimeType","parentFolderId","fileId"],"required":["name","content"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/drive_upload_file"},{"name":"colab_media_rag_search","description":"[CTTB-01 Target] Execute GPU-accelerated semantic multimodal Media RAG search over Google Drive _ENTITIES media assets. Retrieves top matching images, diagrams, game cards, and character art with grounded citations.","parameters":["query","theme","topK","mode","modality"],"required":["query"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_media_rag_search"},{"name":"colab_media_batch_embedder","description":"[CTTB-01 Target] Execute high-throughput GPU batch embedding pipeline on Colab (T4/L4). Stages media assets to /content/scratch SSD (CONV-01) to eliminate Drive FUSE latency, generates Multimodal/MRL embeddings, and atomically updates the Drive embedding registry.","parameters":["theme","batchSize","forceReindex","markReady","accelerator","syncToQdrant","qdrantCollection"],"required":["theme"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_media_batch_embedder"},{"name":"colab_notebook_custom_runner","description":"[CTTB-01 Target] Execute a whitelisted Jupyter Notebook stored in Google Drive (or bookmark alias like @colab:eval) on Colab GPU (T4/L4/A100) with isolated output staging in _프로젝트/colab-workspace/.","parameters":["targetAliasOrFileId","accelerator","parameters","idempotencyKey"],"required":["targetAliasOrFileId"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_notebook_custom_runner"},{"name":"colab_gallery_rag_bundler","description":"[UNAVAILABLE] Gallery bundler is cataloged for compatibility but has no verified outbound runner. It fails closed until an allow-listed Colab runner and independent artifact readback are registered.","parameters":["theme","thumbnailSize","thumbnailQuality","generateColorPalette","accelerator"],"required":["theme"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_gallery_rag_bundler"},{"name":"colab_media_thumbnail_generator","description":"[CTTB-01 Target] High-throughput batch thumbnail generation and color palette extraction pipeline on Colab. Stages Drive media files to /content/scratch (CONV-01), resizes raw media into web-optimized WebP/AVIF thumbnails, extracts dominant color palettes and BlurHash metadata for instant skeleton UI rendering, and writes them back to Google Drive.","parameters":["theme","maxDimension","format","quality","extractPalette","generateBlurHash","outputMode","forceRegenerate","accelerator"],"required":["theme"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_media_thumbnail_generator"},{"name":"colab_semantic_atlas_advisor","description":"[CTTB-01 Target] Inspects Google Drive Semantic Atlas inventory, determines the exact storage directory and next canonical ID, and returns prompt engineering recipes and JSON envelope boilerplates for image generation models.","parameters":["theme","targetConcept","targetSpecId","proposedRole","userPrompt","mediaRoot","mountShare","autoScaffold"],"required":["theme"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_semantic_atlas_advisor"},{"name":"colab_media_vision_captioner","description":"[CTTB-01 Target] Automated GPU Multimodal Vision Captioner and Semantic Tagging pipeline on Colab. Stages raw images to /content/scratch (CONV-01), runs Gemini 1.5 Flash / BLIP2 vision models to extract visual summaries, aesthetic descriptions, and 301-domain taxonomy tags, and automatically scaffolds companion metadata JSON envelopes on Google Drive.","parameters":["theme","model","batchSize","taxonomyScope","outputMode","forceRecaption","accelerator"],"required":["theme"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_media_vision_captioner"},{"name":"colab_document_chunk_indexer","description":"[CTTB-01 Target] GPU Hierarchical Document Chunking & Embedding Indexer on Colab. Stages Google Docs, Markdown specs, and text nodes from Google Drive to /content/scratch SSD (CONV-01), applies hierarchical heading-aware AST chunking, generates 768D text embeddings via Gemini Embedding models, and atomically writes back consolidated JSONL/Parquet datasets to Google Drive.","parameters":["sourcePath","chunkSize","chunkOverlap","embeddingDim","bundleFormat","preserveHierarchy","accelerator","syncToQdrant","qdrantCollection"],"required":["sourcePath"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_document_chunk_indexer"},{"name":"colab_media_dataset_sanitizer","description":"[CTTB-01 Target] High-throughput Media Dataset Sanitizer and Integrity Auditor on Colab. Stages media files to /content/scratch SSD (CONV-01), computes hardware-accelerated SHA-256 digests, validates image headers against corrupt bytes, isolates defective items into _ENTITIES/quarantine/, and produces an actionable hygiene audit report.","parameters":["theme","action","verifySha256","maxScanned","quarantineDir","accelerator"],"required":["theme"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_media_dataset_sanitizer"},{"name":"colab_spec_governance_auditor","description":"[CTTB-01 Target] High-throughput Engineering Spec Governance Auditor, Semantic Diff, Atomic Promotion, and Sheets Control Plane Sync on Colab. Audits _ENTITIES/specs/, enforces NES v0.1 immutability and entity.json activeVersion pointers, computes Markdown AST & semantic diffs, atomically promotes new spec versions with SHA-256 integrity, and synchronizes spec lifecycle states to the Google Sheets [스펙_거버넌스] control plane.","parameters":["action","specId","fromVersion","toVersion","comment","author","accelerator"],"required":["action"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_spec_governance_auditor"},{"name":"colab_entity_graph_auditor","description":"[CTTB-01 Target] High-throughput in-memory metadata scanner & graph topology linter. Audits cross-entity missing links, broken markdown cross-references, media companion CAS integrity, and DAG cycles without small-file Drive FUSE overhead.","parameters":["action","outputDir","severityFilter"],"required":["action"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_entity_graph_auditor"},{"name":"colab_run_rag","description":"Execute high-throughput GPU-accelerated batch embedding or Multimodal Media RAG search on Google Drive assets. Utilizes CONV-01 Tier 0 Scratch staging (/content/scratch) to eliminate Drive FUSE latency and GPU starvation.","parameters":["query","theme","modality","topK","accelerator","stageToScratch","mode"],"required":["query"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_run_rag"},{"name":"colab_execute","description":"Execute a Jupyter Notebook (.ipynb) stored on Google Drive (or local path) on Google Colab GPU (T4/L4/A100), stream results, and save outputs back to Google Drive.","parameters":["driveFileIdOrAlias","accelerator","parameters","saveLogs","idempotencyKey"],"required":["driveFileIdOrAlias"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_execute"},{"name":"colab_runtime_status","description":"Check availability, CLI binary status, authentication state, and supported hardware accelerators for Google Colab and Jupyter execution runtimes.","parameters":[],"required":[],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_runtime_status"},{"name":"auth_status","description":"Check current Google OAuth2 authentication status, active account email, token expiration, and granted scopes for Colab and Drive operations.","parameters":[],"required":[],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/auth_status"},{"name":"colab_session_create","description":"[UNAVAILABLE] Automatic Colab VM provisioning is unsupported. Create a bootstrap notebook in your Drive with colab_bootstrap_create, open it in Colab, and start your own runtime.","parameters":["sessionName","accelerator","highMem"],"required":[],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_session_create"},{"name":"colab_session_stop","description":"[UNAVAILABLE] This service cannot terminate a Google Colab runtime. End the runtime from its Google Colab notebook UI.","parameters":["sessionName"],"required":["sessionName"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_session_stop"},{"name":"colab_session_list","description":"List only this authenticated user’s workers observed through recent daemon heartbeats. This is not an inventory of Google Colab VMs or proof of GPU execution.","parameters":[],"required":[],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_session_list"},{"name":"colab_pipeline_execute","description":"Queue an allowlisted target for the user-owned Colab worker. Returns jobId; actual runId and Drive history are reported after execution. Does not allocate a Colab VM.","parameters":["targetId","arguments","idempotencyKey"],"required":["targetId"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_pipeline_execute"},{"name":"colab_pipeline_status","description":"Read this account’s temporary queue receipt and worker heartbeat. Stalled observation means contact was lost, not that Colab stopped. Durable history is queried separately.","parameters":["runId"],"required":["runId"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_pipeline_status"},{"name":"colab_pipeline_cancel","description":"Cancel a queued job immediately or request cooperative cancellation of a running Colab process. Running cancellation is confirmed only by the worker. Preserve failed/cancelled Scratch; completed writes are not undone.","parameters":["runId"],"required":["runId"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_pipeline_cancel"},{"name":"colab_pipeline_list","description":"List this account’s observed queue jobs and heartbeat state. Active jobs persist until resolved; terminal receipts expire after one hour. Use Drive history for older runs.","parameters":["status","targetId","limit"],"required":[],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_pipeline_list"},{"name":"colab_pipeline_history","description":"Read stored run summaries from the user’s Drive workspace _runs/YYYY-MM. Bounded month-scoped listing; history byte readback does not verify execution or output artifacts.","parameters":["workspaceFolderId","month","status","targetId","limit"],"required":[],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_pipeline_history"},{"name":"colab_pipeline_get_events","description":"Read and validate the contiguous events.jsonl history in Drive. Use the actual runId and month from history; a retained queue jobId may resolve its actual run reference.","parameters":["workspaceFolderId","month","runId","sinceSeq","limit"],"required":["runId"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_pipeline_get_events"},{"name":"colab_pipeline_diff","description":"Compare bounded stored Drive run metadata and reported artifact hashes. Does not download arbitrary artifacts or verify their contents; elapsed values are cumulative.","parameters":["workspaceFolderId","runIdA","runIdB","monthA","monthB"],"required":["runIdA","runIdB"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_pipeline_diff"},{"name":"colab_pipeline_resume","description":"Checkpoint resume is unsupported. Returns an explicit unsupported result; does not submit or restart a job. Use explicit retry for eligible terminal jobs.","parameters":["runId"],"required":["runId"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_pipeline_resume"},{"name":"colab_pipeline_retry","description":"Create at most one durable retry child for a confirmed failed/cancelled attempt of an audited safe target (runtime-smoke or media-thumbnail-generator). Returns the existing child across retries; never restarts completed or uncertain execution. Uses fresh job/run/output identities.","parameters":["runId","idempotencyKey"],"required":["runId","idempotencyKey"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_pipeline_retry"},{"name":"colab_pipeline_recover","description":"Recover a disconnected attempt using the server’s immutable registration and an authenticated terminal seal read from its Drive history. Completed runs are never re-executed. Missing, unsigned, damaged, or still-running histories block recovery. A protocol-3 claim that never registered can be safely closed. Optional retry creates at most one new child for an audited target, without overwriting old results.","parameters":["runId","mode","idempotencyKey"],"required":["runId"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_pipeline_recover"},{"name":"colab_script_list","description":"[CSST-01 Script Store] List all Colab notebooks (.ipynb) and scripts (.py) registered in _ENTITIES/notebooks and catalog.json, with category, hardware accelerator, parameter counts, and bookmarks.","parameters":["category","accelerator","format","query"],"required":[],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_script_list"},{"name":"colab_script_get","description":"[CSST-01 Script Store] Retrieve full metadata, parameter schema, cell breakdown, and conformance report for a specific Colab notebook or Python script.","parameters":["nameOrAlias","includeContent"],"required":["nameOrAlias"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_script_get"},{"name":"colab_script_store","description":"[CSST-01 Script Store] Ingest, validate, sanitize, and persist a Colab notebook (.ipynb) or Python script (.py) into _ENTITIES/notebooks/, sync catalog.json, register @colab:* bookmark, and bind live MCP execution target.","parameters":["name","content","category","description","accelerator","bookmarkAlias","parametersSchema","force"],"required":["name","content"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_script_store"},{"name":"colab_doctor","description":"[CDOC-01] Inspect edge authentication and configured services. Colab runtime, Python dependencies, and execution require separate runtime receipts.","parameters":[],"required":[],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_doctor"},{"name":"colab_bootstrap_create","description":"Copy the published Colab bootstrap release from the server to a specified folder in the authenticated user's Google Drive. The notebook downloads a pinned release bundle without Git, verifies its digest, mounts the user Drive, and starts the user-owned worker.","parameters":["parentFolderId","name","version","bootstrapFileId"],"required":["parentFolderId"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_bootstrap_create"},{"name":"colab_runtime_pair","description":"Approve the public pairing code shown in the user-owned Colab notebook for this account. Never provide a token or secret.","parameters":["pairCode"],"required":["pairCode"],"restEndpoint":"https://colab.suggestions.cc/api/v1/tools/colab_runtime_pair"}]}