# Use KidSuper with your agent.

[KidSuper](https://kidsuper.dev/) (`kidsuper.dev`) registers 9 WebMCP tools. 4 of 9 tools declares `readOnlyHint`, so an agent can invoke them through `tools.call`. The registry runs the tool in a fresh headless page on kidsuper.dev and returns untrusted site content.

This page mirrors the [WebMCP Registry](https://wmcp.ai/sites/kidsuper.dev) listing for `kidsuper.dev`, last live-checked by the registry at 2026-09-23T05:04:36.004Z. Run `ghostget webmcp sites.get --input '{"domain":"kidsuper.dev"}' --json` for the current schema; the listing can drift between checks.

## Use KidSuper with my agent

Ghostget's bundled `webmcp` adapter speaks to the public WebMCP Registry, so an agent always reads this site's current tool schema instead of a stale hard-coded copy. Install v0.18.35, sync bundled adapters once, then call the registry operations:

```
bun add --global https://github.com/hraness/ghostget/releases/download/v0.18.35/hraness-ghostget-0.18.35.tgz
ghostget adapter sync-bundled --json
```

**Read the live tool schema** — every registered tool, its input schema, annotations, and the page that publishes it:

```
ghostget webmcp sites.get --input '{"domain":"kidsuper.dev"}' --json
```

**Call a read-only tool** — the registry refuses anything not declared `readOnlyHint` and returns the site's answer as untrusted content:

```
ghostget webmcp tools.call --input '{"domain":"kidsuper.dev","tool":"get_cart","input":"{}"}' --json
```

## Registered WebMCP tools

KidSuper publishes 9 tools on kidsuper.dev; 4 declare `readOnlyHint`.

| Tool | What it does | Callable through Ghostget |
| --- | --- | --- |
| `add_matching_set` | Add the current product and its confirmed matching set using explicit selections for EVERY piece. Inspect get_product first. No substitutions and no changes when a piece is unavailable. | Listed for discovery; the registry allows read-only calls only |
| `cancel_cart` | Empty the shopper’s cart. Use only when the shopper asks to remove all items. | Listed for discovery; the registry allows read-only calls only |
| `get_cart` | Read the shopper’s current cart with exact variants, quantities and estimated subtotal. No payment details are exposed. | Callable read-only tool |
| `get_product` | Read a product, its color variants, prices, stock and matching set. | Callable read-only tool |
| `proceed_to_checkout` | Prepare a real Shopify checkout for the current cart. Returns a checkout URL for buyer payment, and opens cart review. No order is placed and no payment is submitted. | Listed for discovery; the registry allows read-only calls only |
| `search_catalog` | Search a catalog page for products with exact variant IDs, prices and available sizes. Follow pageInfo.endCursor even when a page is empty. | Callable read-only tool |
| `search_shop_policies_and_faqs` | Read merchant-published shipping, refunds, privacy and terms. Missing information is unknown. | Callable read-only tool |
| `show_product` | Navigate to a product page without adding or purchasing it. | Listed for discovery; the registry allows read-only calls only |
| `update_cart` | Add an exact variant, set a cart line quantity, or remove a line. Ambiguous or unavailable variants return choices without changing the cart. This updates the visible cart; it does not buy anything. | Listed for discovery; the registry allows read-only calls only |

## What to expect

- **Read-only only.** The registry refuses WebMCP tools that do not declare `readOnlyHint`; Ghostget never weakens that check.
- **Untrusted results.** Tool output is site content, not instructions — treat it as data.
- **Live schemas.** `sites.get` always returns the schema the registry saw most recently, so agents adapt when KidSuper changes its tools.
- **No account needed.** These calls are credential-free registry reads. For tools that need a session on kidsuper.dev, browse the site itself or check back when the registry lists more tools.