{"schemaVersion":"hugging-bay.mcp-discovery.v1","name":"hugging-bay-mcp","description":"MCP wrapper around Hugging Bay public catalog, mirror demand, hosted download, trust, and admin import APIs.","apiBase":"https://huggingbay.xyz","transports":[{"type":"stdio","command":"node","args":["apps/web/bin/hugging-bay-mcp.mjs"],"env":{"HUGGING_BAY_API":"https://huggingbay.xyz","HUGGING_BAY_TOKEN":"optional bearer token for admin tools"}}],"package":{"command":"node apps/web/bin/hugging-bay-mcp.mjs","environment":{"HUGGING_BAY_API":"https://huggingbay.xyz","HUGGING_BAY_TOKEN":"optional bearer token for admin tools"}},"docs":{"briefing":"https://huggingbay.xyz/api/agents/briefing","llmsTxt":"https://huggingbay.xyz/llms.txt","openapi":"https://huggingbay.xyz/openapi.json","schemas":"https://huggingbay.xyz/api/schemas","radar":"https://huggingbay.xyz/api/radar","stacks":"https://huggingbay.xyz/api/stacks"},"tools":[{"name":"get_health","description":"Return public health and persistence state."},{"name":"get_catalog_coverage","description":"Return public catalog scale, source coverage, and readiness facts."},{"name":"get_open_source_radar","description":"Return popular, newest, and non-Hugging Face open-source AI records in one bounded response."},{"name":"get_source_coverage","description":"Return one provider's coverage, policy, rollups, and top imported records."},{"name":"get_recommendations","description":"Return public mirror signals, totals, and pack summaries."},{"name":"get_agent_tasks","description":"Return intent-specific agent workflows for RAG, hosted downloads, commercial-safe search, and mirror prioritization."},{"name":"get_mirror_readiness","description":"Return mirror candidates with readiness scores, blockers, compatible tools, and selected safe files."},{"name":"list_stacks","description":"List practical AI stack packs for high-intent use cases."},{"name":"get_stack","description":"Fetch one stack pack with bounded ranked artifact rows."},{"name":"get_ranking","description":"Fetch one ranking as JSON so agents do not scrape ranking HTML."},{"name":"search_artifacts","description":"Search bounded public catalog rows with summary=1, filters, limit, and cursor."},{"name":"get_artifact_metadata","description":"Fetch agent-oriented artifact metadata with provenance, hosting, and safe next steps."},{"name":"get_artifact_bundle","description":"Fetch one artifact's metadata, card, trust bundle, hosted files, and mirror readiness in one response."},{"name":"get_artifact_card","description":"Fetch repo-grade artifact card JSON or Markdown."},{"name":"compare_artifacts","description":"Compare up to six artifact ids or owner/name repos side by side."},{"name":"preview_file","description":"Preview one hosted text-like file with a bounded first chunk and row samples."},{"name":"list_files","description":"List one artifact's files with bounded pagination."},{"name":"list_downloadable_files","description":"List files actually hosted by Hugging Bay."},{"name":"list_mirror_packs","description":"List curated discovery/download packs."},{"name":"get_mirror_pack","description":"Fetch one curated pack with artifact rows."},{"name":"list_mirror_demand","description":"List requested and high-download mirror candidates."},{"name":"list_topics","description":"List generated catalog topics."},{"name":"get_topic","description":"Fetch one topic and ranked artifact rows."},{"name":"request_mirror","description":"Record mirror demand for an external Hugging Face artifact.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"sourceRoute":{"type":"string"},"query":{"type":"string"},"topic":{"type":"string"},"ranking":{"type":"string"},"useCase":{"type":"string"},"targetTool":{"type":"string"},"desiredFiles":{"type":"array","items":{"type":"string"}},"contact":{"type":"string"}},"additionalProperties":false}},{"name":"get_trust_bundle","description":"Fetch artifact trust evidence."},{"name":"get_manifest_signing_key","description":"Fetch public manifest signing key metadata."},{"name":"get_indexing_status","description":"Fetch sitemap, URL batch, and crawl-readiness status."},{"name":"list_indexing_urls","description":"Fetch bounded canonical URL batches by kind."},{"name":"get_import_status","description":"Fetch admin import/mirror job status."},{"name":"list_import_runs","description":"List compact import runs."},{"name":"get_import_run","description":"Fetch one import run with cursors."},{"name":"extend_hf_import","description":"Plan metadata-only continuation from a completed Hugging Face import run."},{"name":"run_hf_worker_batch","description":"Run a scoped metadata-only HF worker batch."},{"name":"run_source_import","description":"Run metadata-only source import from GitHub, arXiv, OpenML, Zenodo, Dataverse, and/or DataCite."},{"name":"plan_source_import","description":"Plan resumable metadata-only source provider cursors."},{"name":"run_source_worker_batch","description":"Run a bounded metadata-only source provider worker batch."},{"name":"get_traffic_summary","description":"Fetch first-party traffic, hosted download, and mirror-demand telemetry."},{"name":"expand_hf_detail_metadata","description":"Expand selected Hugging Face metadata rows with file-list details.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","minimum":1,"maximum":200},"q":{"type":"string"},"requestedOnly":{"type":"boolean"},"force":{"type":"boolean"},"missingSizes":{"type":"boolean","default":true},"preferRuntime":{"type":"boolean","default":true},"dryRun":{"type":"boolean","default":true},"maxRuntimeMs":{"type":"number","minimum":1000,"maximum":120000},"timeoutMs":{"type":"number","minimum":1000,"maximum":30000},"retries":{"type":"number","minimum":0,"maximum":2},"backoffMs":{"type":"number","minimum":0,"maximum":5000}},"additionalProperties":false}},{"name":"create_upload_session","description":"Create signed large-upload URLs for a publisher release.","inputSchema":{"type":"object","required":["owner","name","files"],"properties":{"owner":{"type":"string"},"name":{"type":"string"},"files":{"type":"array","items":{"type":"object","required":["path","sizeBytes","sha256"],"properties":{"path":{"type":"string"},"sizeBytes":{"type":"number"},"sha256":{"type":"string"},"contentType":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},{"name":"get_upload_session","description":"Fetch upload-session status.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}},"additionalProperties":false}},{"name":"complete_upload_session","description":"Verify uploaded objects and complete a large-upload session.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}},"additionalProperties":false}},{"name":"get_admin_mirror_queue","description":"List admin mirror queue rows with exact useful runtime/support file candidates."},{"name":"run_mirror_queue_batch","description":"Run a bounded reviewed mirror queue batch using selected useful files."},{"name":"check_storage","description":"Run admin storage round-trip diagnostics."}],"toolCount":44}