{
  "markdown": "# Bay Run\n\nBay Run is the decision and execution layer for durable specialist Pins at the canonical origin: <https://run.huggingbay.xyz>.\n\nThe default MCP front door is exactly three tools, in this order: `coprocessor`, `run_pin`, `solve_task`.\n\n## Quickstart: connect to MCP\n\nUse the canonical Streamable HTTP MCP endpoint: **<https://run.huggingbay.xyz/mcp/>**. The live\ncopy-paste auth and request contract is kept at <https://run.huggingbay.xyz/quickstart>.\n\nMint a resource-bound demo bearer, then make the primary Guard-first call:\n\n```bash\nBASE=https://run.huggingbay.xyz\nTOKEN=$(curl -fsS -X POST \"$BASE/oauth/token\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"grant_type\":\"urn:bay-run:grant-type:demo\",\"scope\":\"mcp:demo\",\"resource\":\"https://run.huggingbay.xyz/mcp/\"}' \\\n  | python3 -c 'import json,sys; print(json.load(sys.stdin)[\"access_token\"])')\n\ncurl -fsS -X POST \"$BASE/mcp/\" \\\n  -H \"Authorization: Bearer $TOKEN\" \\\n  -H 'Content-Type: application/json' \\\n  -H 'Accept: application/json, text/event-stream' \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"coprocessor\",\"arguments\":{\"user_text\":\"<untrusted request>\"}}}'\n```\n\n`coprocessor` runs the canonical Guard first and never generates text or executes tools. Add\n`documents` when retrieved chunks need bounded post-SAFE reranking. Read its action and evidence\nbefore deciding whether a caller-owned generation or tool call may continue.\n\n## Default MCP tools\n\nPoint an MCP client at **<https://run.huggingbay.xyz/mcp/>**. The public default surface is:\n\n- `coprocessor` — the primary bounded Guard-first call over `user_text` and optional documents.\n- `run_pin` — the direct alias for one of the four canonical Pins, using its published `{pin_id,input}` shape.\n- `solve_task` — the open-ended fallback when no canonical Pin matches; provide `task_description` and `input`.\n\nAdvanced compatibility capabilities remain available through explicit live references:\n\n- [OpenAPI](https://run.huggingbay.xyz/openapi.json)\n- [advanced MCP tools](https://run.huggingbay.xyz/.well-known/mcp/advanced-tools.json)\n- [full LLM reference](https://run.huggingbay.xyz/llms-full.txt)\n- [SDK and framework integrations](docs/integrations.md)\n\n## Trust and data policy\n\nRead the canonical [data policy](https://run.huggingbay.xyz/.well-known/data-policy.json) before\nsending input. The live [quickstart](https://run.huggingbay.xyz/quickstart) documents receipt\nsemantics, 401 recovery, and the published limits; do not infer capabilities from advanced routes.\n\n## Hugging Bay mirror catalog\n\nHugging Bay’s mirror catalog is available at <https://huggingbay.xyz>. Use each artifact's published\ndownload plan for the currently admitted files. A drop-in `HF_ENDPOINT` compatibility origin is not\npart of the public contract yet, so this repository does not advertise one prematurely.\n\nFor current catalog and serving information, use the generated [Bay Run status snapshot](https://run.huggingbay.xyz/status.json).\nMirror counts and family breakdowns are intentionally not copied here because they change.\n",
  "bytes": 3082,
  "sha": "31ed707cb2fe9193fb928c5ea926ecb32c25156569455ceb6fa59087346180fa",
  "repo_slug": "barneywohl/bay-run",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_barneywohl_bay_run_532c5270/readme"
}