{"schemaVersion":"hugging-bay.remote-mcp.v1","generatedAt":"2026-07-07T23:43:27.713Z","name":"hugging-bay-remote-mcp","endpoint":"https://huggingbay.xyz/api/mcp","alias":"https://huggingbay.xyz/mcp","protocol":"JSON-RPC 2.0 over HTTP POST","auth":{"required":false,"mode":"optional bearer token","publicScope":"Unauthenticated requests can call bounded read-only public catalog, trust, mirror-readiness, trending, crawler-policy, and indexing tools.","privateScope":"Account watchlists, saved-search alerts, publisher dashboard, mutating, upload, import, mirror execution, and admin tools require bearer auth or the downloadable stdio MCP server.","authenticatedToolNames":["get_publisher_dashboard","list_saved_searches","list_saved_search_alerts","get_saved_search_digest","save_saved_search","delete_saved_search"]},"methods":["initialize","tools/list","tools/call","ping"],"toolNames":["get_health","get_catalog_coverage","get_open_source_radar","get_trending","get_agent_discovery","get_ai_bot_allowlist","get_ai_search_guidance","get_citation_pack","get_source_coverage","get_recommendations","recommend_artifacts","get_agent_tasks","get_publisher_release_template","list_publishers","get_publisher_profile","get_mirror_readiness","get_mirror_scale_plan","list_stacks","get_stack","list_answer_packs","get_answer_pack","get_ranking","search_artifacts","resolve_artifact","get_artifact","get_artifact_metadata","get_artifact_bundle","get_release_bundle","get_release_readiness","get_artifact_distribution","get_peer_fallbacks","get_artifact_insights","get_local_kit","get_download_plan","get_artifact_card","get_artifact_reviews","get_community_signals","get_review_queue","get_evidence_rollups","compare_artifacts","preview_file","list_files","list_downloadable_files","list_mirror_packs","get_mirror_pack","list_mirror_demand","list_mirrors","list_topics","get_topic","get_trust_bundle","get_manifest_signing_key","get_indexing_status","list_indexing_urls"],"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_trending","description":"Return public trending artifacts from aggregate pageview, download, mirror-request, and product-action signals.","inputSchema":{"type":"object","properties":{"window":{"type":"string","enum":["24h","7d","30d","all"]},"limit":{"type":"number","minimum":1,"maximum":50}},"additionalProperties":false}},{"name":"get_agent_discovery","description":"Return the single-call agent discovery contract for answer engines, OpenClaw/Hermes-style agents, MCP clients, OpenAPI users, crawlers, citation targets, and bounded API entrypoints."},{"name":"get_ai_bot_allowlist","description":"Return the machine-readable AI crawler/user-agent allowlist, official verification links, and WAF guidance."},{"name":"get_ai_search_guidance","description":"Return citation-ready AI-search guidance for Perplexity, ChatGPT, Gemini, Grok, Claude, open agents, and MCP clients."},{"name":"get_citation_pack","description":"Return a compact citation pack for answer engines: safe claims, avoid claims, citation order, proof URLs, and bounded extraction rows.","inputSchema":{"type":"object","properties":{"q":{"type":"string"},"query":{"type":"string"},"slug":{"type":"string"}},"additionalProperties":false}},{"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":"recommend_artifacts","description":"Return ranked artifact recommendations for a concrete use case, with fit reasons, tool commands, and hosted/mirror actions.","inputSchema":{"type":"object","properties":{"useCase":{"type":"string"},"q":{"type":"string"},"tool":{"type":"string","enum":["ollama","lm-studio","comfyui","transformers","llama.cpp"]},"commercial":{"type":"boolean"},"hosted":{"type":"boolean"},"limit":{"type":"number","minimum":1,"maximum":25}},"additionalProperties":false}},{"name":"get_agent_tasks","description":"Return intent-specific agent workflows for RAG, hosted downloads, commercial-safe search, and mirror prioritization."},{"name":"get_publisher_release_template","description":"Return a copyable Hugging Bay release manifest template for labs, including source URLs, hashes, runtime notes, upload-session body, and reviewed fallback fields.","inputSchema":{"type":"object","properties":{"kind":{"type":"string","enum":["llm","dataset","vision","audio","agent","app","eval"]}},"additionalProperties":false}},{"name":"list_publishers","description":"List public publisher namespaces with artifact counts, hosted-file counts, claim state, and trust stats.","inputSchema":{"type":"object","properties":{"q":{"type":"string"},"limit":{"type":"number","minimum":1,"maximum":100}},"additionalProperties":false}},{"name":"get_publisher_profile","description":"Fetch one public publisher namespace profile with releases, hosted files, claim state, and trust stats.","inputSchema":{"type":"object","required":["namespace"],"properties":{"namespace":{"type":"string"},"limit":{"type":"number","minimum":1,"maximum":100}},"additionalProperties":false}},{"name":"get_mirror_readiness","description":"Return mirror candidates with readiness scores, blockers, compatible tools, and selected safe files."},{"name":"get_mirror_scale_plan","description":"Return a public mirror scaling readiness preview with candidate counts, storage readiness, policy, and blockers. Does not expose execution commands or mirror files.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","minimum":1,"maximum":25},"candidateLimit":{"type":"number","minimum":1,"maximum":50},"targetHostedFiles":{"type":"number","minimum":1},"maxPlannedBytes":{"type":"number","minimum":1},"requestedOnly":{"type":"boolean"},"includeSupportOnly":{"type":"boolean"},"includeReviewedRiskyWeights":{"type":"boolean"}},"additionalProperties":false}},{"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.","inputSchema":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}},"additionalProperties":false}},{"name":"list_answer_packs","description":"List citation-ready answer packs for AI search engines, agents, and common open AI artifact questions."},{"name":"get_answer_pack","description":"Fetch one answer pack with short answer, canonical citations, extraction APIs, and ranked rows.","inputSchema":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}},"additionalProperties":false}},{"name":"get_ranking","description":"Fetch one ranking as JSON so agents do not scrape ranking HTML.","inputSchema":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}},"additionalProperties":false}},{"name":"search_artifacts","description":"Search bounded public catalog rows with summary=1, filters, limit, cursor, and optional semantic reranking.","inputSchema":{"type":"object","properties":{"q":{"type":"string"},"limit":{"type":"number","minimum":1,"maximum":200},"cursor":{"type":"string"},"sort":{"type":"string","enum":["best","ready","mirrorable","trust","updated","downloads","stars","demand","mirrors","name","size","license"]},"type":{"type":"string"},"license":{"type":"string"},"task":{"type":"string"},"framework":{"type":"string"},"format":{"type":"string"},"hosting":{"type":"string"},"reviewStatus":{"type":"string","enum":["first-review","needs-evidence","reviewed","verified-run","benchmark"]},"source":{"type":"string"},"commercial":{"type":"string","enum":["1","true"]},"semantic":{"type":"string","enum":["1","true"]},"explain":{"type":"string","enum":["1","true"]}},"additionalProperties":false}},{"name":"resolve_artifact","description":"Resolve an upstream repo URL, owner/name, or artifact id to a Hugging Bay artifact plus hosted/download/mirror actions.","inputSchema":{"type":"object","properties":{"repo":{"type":"string"},"url":{"type":"string"},"q":{"type":"string"},"source":{"type":"string","enum":["huggingface","modelscope","github","zenodo","arxiv","openml","dataverse","datacite","paperswithcode","opendatalab","opencompass"]}},"additionalProperties":false}},{"name":"get_artifact","description":"Fetch one full artifact JSON document by id.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}},"additionalProperties":false}},{"name":"get_artifact_metadata","description":"Fetch agent-oriented artifact metadata with provenance, hosting, and safe next steps.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}},"additionalProperties":false}},{"name":"get_artifact_bundle","description":"Fetch one artifact's metadata, card, trust bundle, hosted files, and mirror readiness in one response.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}},"additionalProperties":false}},{"name":"get_release_bundle","description":"Fetch a launch-ready release bundle for labs and agents: publisher claim, same-as-upstream evidence, trust bundle, hosted files, local-run commands, and reviewed fallback readiness.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}},"additionalProperties":false}},{"name":"get_release_readiness","description":"Fetch a compact release readiness score/checklist for a lab release: namespace, provenance, license, scans, signed manifests, hosted files, runtime guidance, community proof, and reviewed fallback status.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}},"additionalProperties":false}},{"name":"get_artifact_distribution","description":"Fetch one artifact's hosted download state, upstream source, and reviewed peer-assisted fallback metadata.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}},"additionalProperties":false}},{"name":"get_peer_fallbacks","description":"Fetch one artifact's reviewed torrent/magnet fallback bundle, scoped to hosted-file hashes and reviewer evidence.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}},"additionalProperties":false}},{"name":"get_artifact_insights","description":"Fetch one artifact's fit labels, trust gaps, evidence, hardware fit, and mirror decision data.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}},"additionalProperties":false}},{"name":"get_local_kit","description":"Fetch copyable local-use commands, required files, warnings, and next actions for one artifact.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"tool":{"type":"string","enum":["ollama","lm-studio","comfyui","transformers","llama.cpp"]}},"additionalProperties":false}},{"name":"get_download_plan","description":"Fetch a manifest-backed plan for downloading all Hugging Bay-hosted verified files for one artifact.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"tool":{"type":"string","enum":["ollama","lm-studio","comfyui","transformers","llama.cpp"]}},"additionalProperties":false}},{"name":"get_artifact_card","description":"Fetch repo-grade artifact card JSON or Markdown.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"markdown":{"type":"boolean"}},"additionalProperties":false}},{"name":"get_artifact_reviews","description":"Fetch public community ratings, reviews, and verified-run attestations for an artifact.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"limit":{"type":"number","minimum":1,"maximum":200}},"additionalProperties":false}},{"name":"get_community_signals","description":"Fetch aggregate public community trust signals, recent reviews, and top helpful reviews.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","minimum":1,"maximum":100}},"additionalProperties":false}},{"name":"get_review_queue","description":"Fetch high-priority artifacts that need community reviews, verified-run evidence, or benchmark reports.","inputSchema":{"type":"object","properties":{"mode":{"type":"string","enum":["first-review","needs-evidence","verified-run","benchmark"]},"hosting":{"type":"string","enum":["actionable","hosted","reviewable","all"]},"maxReviews":{"type":"number","minimum":0,"maximum":25},"limit":{"type":"number","minimum":1,"maximum":100}},"additionalProperties":false}},{"name":"get_evidence_rollups","description":"Fetch public benchmark/evidence rollups grouped by benchmark, tool, and hardware.","inputSchema":{"type":"object","properties":{"limit":{"type":"number","minimum":1,"maximum":100}},"additionalProperties":false}},{"name":"compare_artifacts","description":"Compare up to six artifact ids or owner/name repos side by side.","inputSchema":{"type":"object","required":["ids"],"properties":{"ids":{"type":"array","minItems":1,"maxItems":6,"items":{"type":"string"}}},"additionalProperties":false}},{"name":"preview_file","description":"Preview one hosted text-like file with a bounded first chunk and row samples.","inputSchema":{"type":"object","required":["id","path"],"properties":{"id":{"type":"string"},"path":{"type":"string"}},"additionalProperties":false}},{"name":"list_files","description":"List one artifact's files with bounded pagination.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"limit":{"type":"number","minimum":1,"maximum":500},"cursor":{"type":"string"},"tool":{"type":"string","enum":["ollama","lm-studio","comfyui","transformers","llama.cpp"]}},"additionalProperties":false}},{"name":"list_downloadable_files","description":"List files actually hosted by Hugging Bay.","inputSchema":{"type":"object","properties":{"q":{"type":"string"},"pack":{"type":"string"},"artifactId":{"type":"string"},"path":{"type":"string"},"sourceKind":{"type":"string"},"tool":{"type":"string","enum":["ollama","lm-studio","comfyui","transformers","llama.cpp"]},"limit":{"type":"number","minimum":1,"maximum":1000}},"additionalProperties":false}},{"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_mirrors","description":"List registered Hugging Bay mirror nodes and health state.","inputSchema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"list_topics","description":"List generated catalog topics."},{"name":"get_topic","description":"Fetch one topic and ranked artifact rows."},{"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, with optional artifact source/type/tool filters.","inputSchema":{"type":"object","properties":{"kind":{"type":"string","enum":["static","publisher","ranking","stack","intent","answer","citation-pack","source","topic","artifact","artifact-section","artifact-evidence","downloadable","agent-doc"]},"limit":{"type":"number","minimum":1,"maximum":1000},"cursor":{"type":"string"},"q":{"type":"string"},"source":{"type":"string"},"type":{"type":"string"},"license":{"type":"string"},"format":{"type":"string"},"hosting":{"type":"string"},"reviewStatus":{"type":"string","enum":["first-review","needs-evidence","reviewed","verified-run","benchmark"]},"tool":{"type":"string","enum":["ollama","lm-studio","comfyui","transformers","llama.cpp"]},"worksWith":{"type":"string","enum":["ollama","lm-studio","comfyui","transformers","llama.cpp"]},"commercial":{"type":"boolean"},"verified":{"type":"boolean"},"sort":{"type":"string","enum":["best","ready","mirrorable","trust","downloads","stars","mirrors","demand","name","size","license","updated"]}},"additionalProperties":false}}],"examples":{"listTools":{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}},"search":{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_artifacts","arguments":{"q":"small embedding model","limit":5,"semantic":"1","explain":"1"}}},"inspect":{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_artifact_bundle","arguments":{"id":"{artifact_id}"}}}},"discovery":{"mcpManifest":"https://huggingbay.xyz/.well-known/mcp.json","mcpServerCard":"https://huggingbay.xyz/.well-known/mcp/server-card.json","llmsTxt":"https://huggingbay.xyz/llms.txt","aiSearch":"https://huggingbay.xyz/api/ai-search","aiCitations":"https://huggingbay.xyz/api/citations","openapi":"https://huggingbay.xyz/openapi.json","crawlerPolicy":"https://huggingbay.xyz/.well-known/ai-crawler-policy.json","botAllowlist":"https://huggingbay.xyz/.well-known/ai-bot-allowlist.json","indexingBatch":"https://huggingbay.xyz/api/indexing/urls?kind=agent-doc&limit=100","stableApiV1":"https://huggingbay.xyz/api/v1"}}