# Use MCP Toplist with your agent.

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

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

## Use MCP Toplist 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":"mcptoplist.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":"mcptoplist.com","tool":"get_current_page","input":"{}"}' --json
```

## Registered WebMCP tools

MCP Toplist publishes 5 tools on mcptoplist.com; 4 declare `readOnlyHint`.

| Tool | What it does | Callable through Ghostget |
| --- | --- | --- |
| `get_current_page` | Describe the mcptoplist.com page currently open in this tab: which MCP server or organization it is about (with its serverKey), or which ranking hub it is. No side effects. | Callable read-only tool |
| `get_server_details` | Get the full record for one MCP server by its exact serverKey (from search_servers or get_current_page): full description, rank, score, stars, version count, registry listings, auth/setup requirements and the install/connect config when kno | Callable read-only tool |
| `list_top_servers` | List the highest-ranked MCP servers on mcptoplist.com by composite score (GitHub stars, package downloads, release activity, registry coverage). Use when the user wants the best or most popular MCP servers overall rather than a keyword matc | Callable read-only tool |
| `open_server_page` | Navigate this tab to the mcptoplist.com page for an MCP server (its ranking, description, install snippets and connect config). Reversible with the browser back button. | Listed for discovery; the registry allows read-only calls only |
| `search_servers` | Search the mcptoplist.com catalog of 55,000+ Model Context Protocol (MCP) servers by keyword (e.g. "postgres database", "browser automation", "stripe payments"). Matches server names, organizations and descriptions, ranked by relevance and | Callable read-only tool |

## 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 MCP Toplist changes its tools.
- **No account needed.** These calls are credential-free registry reads. For tools that need a session on mcptoplist.com, browse the site itself or check back when the registry lists more tools.