# Use pdfcn with your agent.

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

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

## Use pdfcn 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":"pdfcn.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":"pdfcn.dev","tool":"pdfcn_fetch_registry","input":"{}"}' --json
```

## Registered WebMCP tools

pdfcn publishes 12 tools on pdfcn.dev; 4 declare `readOnlyHint`.

| Tool | What it does | Callable through Ghostget |
| --- | --- | --- |
| `pdfcn_apply_theme` | Navigate to the Theme Builder with a specific theme pre-loaded. The user can then customize it visually. Returns the URL the browser will navigate to. | Listed for discovery; the registry allows read-only calls only |
| `pdfcn_fetch_registry` | Fetch the full shadcn registry manifest for pdfcn. Returns all available components, blocks, themes, and utilities with their file structures and dependencies. | Callable read-only tool |
| `pdfcn_generate_pdf` | Generate and download a PDF document. Opens the PDF in a new browser tab for viewing or downloading. Uses the template's default sample data. | Listed for discovery; the registry allows read-only calls only |
| `pdfcn_get_block` | Get the data schema and installation command for a specific PDF template. Use this to understand what data fields are needed to populate the template. | Listed for discovery; the registry allows read-only calls only |
| `pdfcn_get_install_command` | Get the npx shadcn add command to install a specific pdfcn component or block into the user's project. | Callable read-only tool |
| `pdfcn_get_theme` | Get the full token details for a specific PDF theme, including all colors, typography, spacing, and page settings. | Listed for discovery; the registry allows read-only calls only |
| `pdfcn_list_blocks` | List all available PDF document templates (invoices and reports). Use this to find the right template before generating a PDF. | Listed for discovery; the registry allows read-only calls only |
| `pdfcn_list_docs` | List all available documentation pages with their paths and descriptions. Use this to discover what documentation is available. | Callable read-only tool |
| `pdfcn_list_themes` | List all available PDF themes with their color palettes, typography, and page settings. Use this to discover themes before applying one. | Listed for discovery; the registry allows read-only calls only |
| `pdfcn_open_docs` | Navigate to a pdfcn documentation page. Use this to learn about components, theming, installation, or any other topic. | Listed for discovery; the registry allows read-only calls only |
| `pdfcn_preview_block` | Open a PDF preview for a template in a new browser tab. The preview uses sample data and the current theme. | Listed for discovery; the registry allows read-only calls only |
| `pdfcn_search_components` | Search the pdfcn component registry by name or description. Returns matching components, blocks, themes, and utilities with install commands. | 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 pdfcn changes its tools.
- **No account needed.** These calls are credential-free registry reads. For tools that need a session on pdfcn.dev, browse the site itself or check back when the registry lists more tools.