Tool reference · open
list_repos
List the repositories I can work on (free)
Lists real repository names so a run never starts on a guessed one, and answers whether a repository can be written to. Pass `github_token` to see everything that token can see, or `owner` to list a public account's repositories; with neither, it lists the repositories the SHPBL GitHub App is installed on for this key — the same ones a pull request can be opened on. Pass `repo: "owner/name"` to ask about one target instead of reading the whole list. Free — costs no allowance.
Call it
curl -X POST https://shpbl.com/api/public/v1/tools/list_repos \
-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.
Optional arguments
github_token
A GitHub token (PAT or fine-grained) to list with. Never stored, never logged — used for this call only.
owner
A GitHub user or organisation to list the public repositories of, when no token is available.
key
Your SHPBL key (shpbl_mcp_…), only needed to list App-connected repositories. Optional if sent as the Authorization header.
limit
How many repositories to return (default 30, max 100).
page
Which page of the connected-repository list to return, 1-based. Use this rather than a higher `limit` past 100; the response names the next page when there is one.
repo
Ask about one target, `owner/repo`: whether this key may open a pull request on it. Call this before offering to write.