Tool reference · open
pin_source
Pin a repository for step 1
Build `HOST-SOURCE-MANIFEST.json` for canonical step 1 from a GitHub repository, online, with no clone and no download: every file's Git blob identity, the byte length, the head commit, and the `SHPBL-SOURCE-DIGEST/1` digest over the pinned tree. Write the returned JSON to your run folder as `HOST-SOURCE-MANIFEST.json` and step 1 passes the gate. Free and unmetered. If the run is offline instead, do not call this — run `node tools/source-manifest.mjs <repo-dir|repo.zip>` from the edition, which produces the same manifest from a directory or straight out of the repository ZIP. Never invent the digest or the commit.
Call it
curl -X POST https://shpbl.com/api/public/v1/tools/pin_source \
-H 'content-type: application/json' \
-H 'authorization: Bearer shpbl_mcp_…' \
-d '{}'Same handler over MCP. The free lane needs no key; a Practitioner key is what keeps a run.
Required arguments
repo
A GitHub repository: `owner/repo`, a github.com URL, or `owner/repo#branch`.
Optional arguments
key
Your SHPBL key, if you have one. Optional — this tool is free; a key only helps reach a private repository through a connected GitHub App install.
github_token
Optional GitHub token (Contents: read) for a private repository.
label
What to call the target in the manifest. Defaults to `owner/repo@branch`.