{"schema":"bay-run.grok-mcp.v1","service":"Bay Run","canonical_url":"https://run.huggingbay.xyz/grok","purpose":"Connect Grok to Bay Run's focused decision and execution loop without loading the advanced compatibility tools into Grok's context.","discovery":{"robots":"https://run.huggingbay.xyz/robots.txt","sitemap":"https://run.huggingbay.xyz/sitemap.xml","llms":"https://run.huggingbay.xyz/llms.txt","llmsFull":"https://run.huggingbay.xyz/llms-full.txt","openapi":"https://run.huggingbay.xyz/openapi.json","agentCard":"https://run.huggingbay.xyz/.well-known/agent-card.json","agentDiscovery":"https://run.huggingbay.xyz/.well-known/agent-discovery.json","mcpManifest":"https://run.huggingbay.xyz/.well-known/mcp.json","mcpEndpoint":"https://run.huggingbay.xyz/mcp","grokConnector":"https://run.huggingbay.xyz/.well-known/grok.json","x402":"https://run.huggingbay.xyz/.well-known/x402","oauthProtectedResource":"https://run.huggingbay.xyz/.well-known/oauth-protected-resource","oauthAuthorizationServer":"https://run.huggingbay.xyz/.well-known/oauth-authorization-server","security":"https://run.huggingbay.xyz/.well-known/security.txt","trafficAdvice":"https://run.huggingbay.xyz/.well-known/traffic-advice","assetLinks":"https://run.huggingbay.xyz/.well-known/assetlinks.json","indexNow":"https://run.huggingbay.xyz/.well-known/indexnow.json"},"mcp":{"server_url":"https://run.huggingbay.xyz/mcp/","transport":"streamable-http","server_label":"bay_run","stateless":true,"primary_tools":["solve_task","run_bakeoff","get_task_quote","run_task","verify_result"],"advanced_tools":"https://run.huggingbay.xyz/.well-known/mcp/advanced-tools.json"},"authentication":{"type":"oauth2_bearer","protected_resource":"https://run.huggingbay.xyz/.well-known/oauth-protected-resource/mcp","authorization_server":"https://run.huggingbay.xyz/.well-known/oauth-authorization-server","zero_secret_demo_mint":{"method":"POST","url":"https://run.huggingbay.xyz/oauth/token","content_type":"application/json","body":{"grant_type":"urn:bay-run:grant-type:demo","scope":"mcp:demo","resource":"https://run.huggingbay.xyz/mcp/"},"response_binding":"access_token -> BAY_RUN_TOKEN"},"custom_connector":"Use Grok's OAuth flow. Do not paste an owner-management, billing:write, or operator credential into Grok."},"grok_custom_connector":{"setup_url":"https://grok.com/connectors","connector_type":"Custom MCP","server_url":"https://run.huggingbay.xyz/mcp/","steps":["Create a Custom MCP connector.","Enter https://run.huggingbay.xyz/mcp/ as the server URL.","Complete the OAuth flow when Grok requests authentication.","Keep only the five primary tools enabled unless an advanced primitive is required."]},"grok_build":{"add_command":"grok mcp add --transport http bay-run https://run.huggingbay.xyz/mcp/","doctor_command":"grok mcp doctor bay-run --json","oauth":"Grok Build opens the OAuth flow on first protected tool use."},"xai_remote_mcp":{"model":"grok-4.6","captured_at":"2026-08-19","tool":{"type":"mcp","server_url":"https://run.huggingbay.xyz/mcp/","server_label":"bay_run","server_description":"Find and run a small specialist for a task under explicit quality, latency, data-handling, and price constraints; return a verifiable result.","allowed_tools":["solve_task","run_bakeoff","get_task_quote","run_task","verify_result"],"authorization":"$BAY_RUN_TOKEN","headers":{"X-Bay-Run-Source":"grok","X-Bay-Run-Harness":"grok","X-Bay-Run-Client-Class":"agent_harness"}},"native_sdk_parameter_aliases":{"allowed_tools":"allowed_tool_names","headers":"extra_headers"},"note":"xAI's authorization field receives the token value and sets the Authorization header on requests to Bay Run."},"tool_selection":{"solve_task":"One-off task with input; route, execute, and return a receipt.","run_bakeoff":"Measure only the detected family's resident warm candidates from 3-10 labels; expect no_specialists for an underfilled field or weak=true near chance.","get_task_quote":"Get the free bounded route decision for a recurring task.","run_task":"Execute a quote under max_price_usd and an idempotency key.","verify_result":"Verify the execution, charge, restrictions, and receipt evidence."},"recovery":{"401":"Follow WWW-Authenticate and the RFC 9728 protected-resource metadata, complete OAuth or mint the resource-bound demo bearer, then retry the same POST.","405":"MCP JSON-RPC uses POST; GET returns discovery only.","422":"Call tools/list again and retry with the selected tool's exact inputSchema.","503":"Check /readyz and Retry-After before retrying."},"data_and_trust":{"review_before_sensitive_data":"https://run.huggingbay.xyz/.well-known/data-policy.json","assurance_and_limitations":"https://run.huggingbay.xyz/.well-known/assurance.json","security_policy":"https://run.huggingbay.xyz/security","service_status":"https://run.huggingbay.xyz/status.json","pricing":"https://run.huggingbay.xyz/.well-known/pricing"},"attribution":{"optional_headers":{"X-Bay-Run-Source":"grok","X-Bay-Run-Harness":"grok","X-Bay-Run-Client-Class":"agent_harness"},"privacy":"Bay Run stores only bounded attribution labels and rotating correlations; these headers do not authenticate xAI or identify a person."},"official_xai_docs":{"custom_connectors":"https://docs.x.ai/grok/connectors","remote_mcp":"https://docs.x.ai/developers/tools/remote-mcp","grok_build_mcp":"https://docs.x.ai/build/features/mcp-servers"}}