punchline!

Use

Site Doctor

"Is Punchline working on my site?" The Doctor section of the dashboard answers that in plain words, and explains the three things people ask about most: why a visit got its label, where a handoff link went, and what an agent gets from a page. Anyone who can see a site's reports can use it.

Site check

Doctor → Site check runs a set of checks over the last 24 hours and shows each as a finding with, when it isn't fine, what to do:

  • Receiving. When the last page view arrived and how many came in. Six quiet hours on a site that was reporting is a warning; nothing in 24 hours is a problem.
  • Edge install. Whether an edge install (the Next.js package, the Vercel middleware or the Cloudflare Worker) is reporting. Only the edge sees agents that never run JavaScript, so a snippet-only site is warned.
  • Browser snippet and allowed hosts. Whether the snippet is reporting, and whether the collector refused any of its beacons today because the page's host isn't in the site's allowed list. That's the usual cause of "I installed the snippet and see nothing".
  • MCP server, when the site has one: calls in the window.
  • Plan usage this month and the daily flood ceiling.
  • Settings that change what shows up: markdown for assistants, AI access.

If you manage several sites, the page ends with all of them, worst first.

Send a test visit

The button fetches one page of your site the way an agent would, then looks for that visit in your data. It identifies itself as PunchlineDoctor/1.0, a self-declared fetcher, so your reports show it as an agent and never as a person or as an impostor of a real assistant. It tells you:

  • whether the page answered, redirected or refused the request (a 403 usually means a bot blocker);
  • whether the edge install counted the request and whether the snippet tag is on the page;
  • whether asking for markdown got a markdown version, and a share link if those are on;
  • whether the visit then arrived and was labelled, with a link to its session.

Up to 30 test visits an hour per site. Only pages on the site's domain and its allowed hosts can be fetched.

Explain

Doctor → Explain has three forms. Nothing you paste into them is stored or logged.

Why would this be labelled…? Paste a user agent and, if you have it, the IP address, path and referrer host. The request is classified exactly as the collector would classify it: the label, every rule that fired and what each means, the evidence, the network type for the address, and what the visit counts as at each confidence setting. Use it when a customer or colleague asks why their traffic shows as agents, or to check a user agent from a vendor's documentation before it reaches your site.

Where did this handoff link go? Paste the link an agent gave its person, or the token after pl_ho=. Only the token's hash is stored, so the lookup is exact: what kind of link it is, when it was minted, whether the mint was tied to the agent's session (and what to send if it wasn't), and whether a person has opened it or only an agent or a link preview so far.

What does an agent get from a page? The same test visit as above, for any page on the site.

In Ask Punchline

Ask Punchline has the same checks as tools: check_install, explain_request, lookup_handoff and check_page. "Acme says they see nothing since Tuesday" runs the install check and a page check and reports what it found. These tools are only in the dashboard's assistant; the MCP server and API don't expose them.

Ask the docs

Answers come from these docs only, written by Claude (Anthropic). Your question is sent to answer it, and isn't stored.