# Use SuggestAPI - The Discovery Layer with your agent.

[SuggestAPI - The Discovery Layer](https://suggestapi.com/) (`suggestapi.com`) registers 9 WebMCP tools. 7 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 suggestapi.com and returns untrusted site content.

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

## Use SuggestAPI - The Discovery Layer 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":"suggestapi.com"}' --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":"suggestapi.com","tool":"fetch_agent_skills_index","input":"{}"}' --json
```

## Registered WebMCP tools

SuggestAPI - The Discovery Layer publishes 9 tools on suggestapi.com; 7 declare `readOnlyHint`.

| Tool | What it does | Callable through Ghostget |
| --- | --- | --- |
| `fetch_agent_skills_index` | Fetch the Agent Skills discovery index at /.well-known/agent-skills/index.json (RFC v0.2.0). Returns skill stubs with name, type, description, url, and sha256 digest for install/verify. Use this for structured skill listing; use fetch_agent | Callable read-only tool |
| `fetch_agents_md` | Fetch /agents.md as { format, content }. Markdown integration guide for Knowledge Gateway (agent.suggestapi.com) and search API discovery, including optional docs this page does not fetch (okg.json, ai-catalog.json, agent-card.json, openapi | Callable read-only tool |
| `fetch_api_catalog` | Fetch the RFC 9727 API catalog (application/linkset+json) from https://agent.suggestapi.com/.well-known/api-catalog. Returns hrefs only (webmcp, mcp, mcp-server, mcp-manifest) — not tool names or schemas. These commerce tools are not regist | Callable read-only tool |
| `fetch_gateway_webmcp` | Fetch the Knowledge Gateway WebMCP manifest at https://agent.suggestapi.com/.well-known/webmcp. Returns name, origin, mcpEndpoint, and tools[] with inputSchema, REST endpoint, and method (search, recommend, compare, product_lookup). These t | Callable read-only tool |
| `fetch_llms_txt` | Fetch /llms.txt as { format, content }. Plain-text site overview: product themes, Markdown page URLs, and discovery links. Prefer list_site_pages for a compact HTML nav list; prefer fetch_agents_md for the integration guide. | Callable read-only tool |
| `get_page_info` | Return metadata about the current SuggestAPI page (title, URL, description, canonical). | Callable read-only tool |
| `list_site_pages` | Return a short hardcoded nav list of key HTML marketing pages (path, title, url). Use for in-browser navigation. For a full prose map with Markdown URLs and gateway/API links, use fetch_llms_txt. | Callable read-only tool |
| `navigate_to_page` | Navigate the browser to a public SuggestAPI marketing page. | Listed for discovery; the registry allows read-only calls only |
| `scroll_to_signup` | Scroll to the signup section on the current page (if present) and return whether it was found. | 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 SuggestAPI - The Discovery Layer changes its tools.
- **No account needed.** These calls are credential-free registry reads. For tools that need a session on suggestapi.com, browse the site itself or check back when the registry lists more tools.