Dogfooding SandBase: discover and inspect a GitHub connector before running it

[liyangbing]

I wanted a small, reproducible example of the workflow SandBase CLI recommends: discover first, inspect the live schema and price, then decide whether to execute.

1. Discover by a short task keyword

From an AI client connected through SandBase CLI, ask the agent to call:

sandbase_discover({"q":"github","limit":10})

The live catalog returned eight candidates. The directly relevant result was:

{
  "model": "sandbase/github",
  "tool_name": "sandbase_sandbase_github",
  "description": "Access the full GitHub REST API through OAuth.",
  "pricing": { "base_price": "0.001" }
}

A useful troubleshooting detail: a longer natural-language query returned no matches, while the shorter github keyword found the connector. If discovery is empty, simplify the keyword before assuming the capability is unavailable.

2. Inspect before running

sandbase_inspect({"name":"sandbase/github"})

The inspected schema currently requires endpoint and accepts these optional fields:

• method: GET, POST, PUT, PATCH, or DELETE
• params: URL query parameters
• headers: additional request headers
• body: request body for write methods
• retries: integer from 0 to 5

The inspected price was $0.001 per execution. Catalog entries, schemas, and pricing can change, so use the response from your current session rather than copying this value into production logic.

3. Review the intended request

For a read-only repository lookup, the proposed execution arguments would be:

{
  "endpoint": "/repos/sandbaseai/cli",
  "method": "GET",
  "retries": 1
}

I stopped before sandbase_run, so this example does not claim an execution result. The important pattern is reviewable:

discover → inspect current schema and price → confirm endpoint and method → run

That same pattern applies to search, social, model, image, video, and other catalog capabilities. For mutating methods, review the endpoint and body explicitly before approving the call.

Install or connect the bridge from the SandBase CLI README. If this inspect-before-run workflow is useful, a Star helps other agent builders find the project.

Disclosure: this official SandBase example was prepared with AI assistance from live sandbase_discover and sandbase_inspect responses on 2026-08-28. No sandbase_run call was made.