orient
Orient in the SandboxAPIs universe
START HERE. Returns everything needed to use SandboxAPIs with no docs: the universe/theme, every API surface and its base URL (git hosts and issue trackers), live-vs-snapshot modes and how to pin, the org and its teams/repos, notable entry points (each with a ready-to-run REST path), where the coverage manifest lives, and this server's access block: whether a key is set and how many requests are left this hour. Writes: this server is READ-ONLY, including for a scratch-enabled key. The scratch layer (a per-key, 24-hour overlay: GitHub issues and issue comments, Jira comments and transitions, and Slack messages into existing channels) is a REST feature, so use the GitHub, Jira or Slack base URL above with your key for it, and expect the tools here to answer from the shared data set alone.
Takes no parameters.
check_budget
Check the remaining request budget
Costs nothing. Call it before any loop of more than a handful of requests. Returns this server's real hourly window (limit, remaining, when it resets) read from the provider's own budget endpoint, which is exempt from the budget it reports, plus whether a key is set and where to raise the limit. The window is ONE bucket per caller shared across every provider host, so the numbers apply to all of them.
Parametersprovider
list_repositories
List the org's repositories
List repositories for the universe's org. Results are identical to the provider's REST API and carry provider-form ids (node_id / numeric id).
Parametersproviderrequired
get_repository
Get a repository
Fetch one repository by name (default: the flagship repo). Provider-shaped, with provider-form ids.
Parametersrepoproviderrequired
list_pull_requests
List pull requests / merge requests
List a repo's pull requests (GitHub) or merge requests (GitLab). Optional state filter.
Parametersrepostateproviderrequired
get_pull_request
Get a pull/merge request with its reviews
Fetch one PR (GitHub) / MR (GitLab) plus its reviews (GitHub) / approvals (GitLab). Returns both in one result; each carries provider-form ids for cross-referencing.
Parametersreponumberrequiredproviderrequired
List a repo's issues. Optional state filter (open/closed/all).
Parametersrepostateproviderrequired
Fetch a user by login/username. Provider-shaped, with provider-form ids.
Parametersloginrequiredproviderrequired
search_commits_by_author
Search commits by author
Find commits authored by a given login in a repo. Returns SHAs (identical across GitHub and GitLab, invariant #5) with a REST path to fetch each, so you can cross-reference against either provider.
Parametersrepoauthorrequiredprovider
get_snapshot
Get a pinned snapshot hostname
Return the pinned, reproducible hostname for a provider. Point your client's base URL at it for drift-free CI. A snapshot regenerates byte-identically on every request.
Parametersproviderrequired
