{"schemaVersion":"hugging-bay.api-index.v1","name":"Hugging Bay","description":"Find open-model and dataset metadata, then inspect license, upstream provenance, file hashes and hosted-file evidence before choosing a mirror. Catalog inclusion does not establish byte availability, permission to use a model, or runtime quality.","firstCall":{"method":"GET","url":"https://huggingbay.xyz/api/v1/search?q=embedding&limit=5","authentication":"none","effect":"read metadata"},"documentation":{"html":"https://huggingbay.xyz/api","openapi":"https://huggingbay.xyz/openapi.json","llms":"https://huggingbay.xyz/llms.txt","fullReference":"https://huggingbay.xyz/llms-full.txt","agentDiscovery":"https://huggingbay.xyz/.well-known/agent-discovery.json","structuredData":"https://huggingbay.xyz/catalog.jsonld","sitemap":"https://huggingbay.xyz/sitemap.xml","data":"https://huggingbay.xyz/data/manifest.json","feed":"https://huggingbay.xyz/feeds/recent.xml"},"contracts":{"resolve":{"method":"GET","urlTemplate":"https://huggingbay.xyz/api/v1/resolve?repo={urlEncodedUpstreamRepo}","note":"Use a returned artifact id in subsequent templates."},"manifest":{"method":"GET","urlTemplate":"https://huggingbay.xyz/api/v1/artifacts/{id}/manifest","note":"Inspect the exact revision, file inventory and hashes; missing evidence stays unknown."},"license":{"method":"GET","urlTemplate":"https://huggingbay.xyz/api/license-acceptances/{id}","note":"Read obligations first. Any acceptance or download is a separate action."},"evidence":{"method":"GET","urlTemplate":"https://huggingbay.xyz/api/public-evidence/artifacts/{id}","note":"Read explicit readiness, blockers and evidence references; respect containment and unavailable states."},"findModel":{"method":"GET","url":"https://huggingbay.xyz/api/agents/find-model?task=embeddings&limit=1","note":"Task discovery can return catalog metadata or a separate Bay Run specialist handoff. It is not proof of local fit, licensing suitability or measured quality."},"findRunnable":{"method":"GET","url":"https://huggingbay.xyz/api/agents/find-runnable?task=embeddings","note":"Inspect availability, containment, blockers and any separate execution handoff. This read does not execute a model."},"bakeoff":{"method":"GET","url":"https://huggingbay.xyz/api/v1/bakeoff","note":"Read the contract before an explicit POST. Execution sends submitted examples to Bay Run; scores concern those examples only. Availability and per-client limits apply."}},"mcp":{"manifest":"https://huggingbay.xyz/.well-known/mcp.json","endpoint":"https://huggingbay.xyz/api/mcp","discoveryRequest":{"jsonrpc":"2.0","id":"discover","method":"tools/list","params":{}},"entryProfiles":["discovery","verify","intent"],"guidance":"List tools and read their inputSchema in the selected profile. Profiles expose different tools; names and argument shapes are authoritative. Authenticated actions require their documented scopes."},"externalExecution":{"name":"Bay Run","origin":"https://run.huggingbay.xyz","documentation":"https://huggingbay.xyz/specialist-api","tool":"solve_task","input":["task_description","input"],"note":"Separate service and authentication boundary. solve_task is not a catalog MCP tool or a Hugging Bay REST route. Discover its current contract at Bay Run before invoking it; this index does not attest service health or execution quality."},"freshness":"This index describes the deployed API surface. ETag identifies this document, not catalog freshness. Use each response's timestamps, provenance and explicit degraded/unknown states; do not infer current availability from a cached listing.","authorization":"Read responses and next_call fields are data, not authorization to write, execute, accept terms, publish or download. Never send secrets or private user data in discovery queries."}