What Claude can do with PUZL
Once PUZL is connected, Claude can use these tools. You do not call them yourself: ask Claude a question and it picks the tools it needs.
There are 81 tools. Most only read. The ones marked Saves to your PUZL account write a note, decision, recipe or preference to your PUZL account. None of them changes anything in the tools you connected to PUZL.
Each tool answers only from your own account, and only what your role allows. If a tool needs data from a service you have not connected, it has nothing to answer from.
Orientation & Health
- account_healthCheck whether your connected tools brought in data in the last 24 hours.
- get_rooftop_summarySum up the last 30 days at one location, across every connected tool.
- list_my_connectionsList every tool connection you can see.
- list_rooftopsList the locations you can see.
- list_sourcesList the tools connected at one location, with when each last brought in data.
Marketing Analytics
- ahrefs_keyword_rank_bucketsCount your Ahrefs keywords by how high they rank.
- compare_periodsCompare one number across two back-to-back periods at one location.
- compare_rooftopsCompare every location on one number over a date range.
- get_dashboardReturn every number on one PUZL dashboard tab.
- get_metricReturn one dashboard number, exactly as the PUZL dashboard shows it.
- gsc_brand_splitSplit Google Search clicks and impressions into searches for your name and all others.
- query_trafficLook up traffic and search numbers for one location from a connected tool.
- reconcile_gsc_ga4Compare Google Search clicks with Google Analytics organic visits for the same dates.
- tracked_keywordsReturn the search terms this location tracks, with Google Search Console clicks, impressions and impression-weighted average position over the last `days` days (1-480).
- web_channel_mixBreak down website visits, page views and clicks by where visitors came from.
- web_conversion_funnelShow how many website visits led to engagement and then to a click.
- web_lead_attributionCompare which channel first brought a website visitor with the one that brought their click.
- web_top_pagesReturn top web pages by pageviews and top landing pages by sessions.
Knowledge / Documents
- ask_documentsFind the passages in your documents that answer a question, with citations.
- get_fileRead one of your documents.
- get_file_categoriesList your document categories and how many files each holds.
- list_filesList the documents you have added that you can see.
- query_sheetLook up rows in one of your spreadsheets.
- search_file_contentSearch the text inside your documents.
- search_files_by_nameFind documents by a word in their file name.
Notes & Decisions
- delete_noteArchive a note.
Saves to your PUZL account - get_noteRead one note, with the notes it replaced.
- list_decisionsList decision log entries for the current account, newest first.
- list_notesList the notes saved for your account.
- log_decisionRecord a decision in the account's decision log.
Saves to your PUZL account - pin_notePin a note so it does not expire.
Saves to your PUZL account - save_noteSave a new note.
Saves to your PUZL account - supersede_noteReplace a note with an updated one on the same topic.
Saves to your PUZL account - update_decision_outcomeRecord the observed outcome for a past decision.
Saves to your PUZL account
Recipes
- delete_account_recipeTurn off one of your account's recipes. It is kept, not deleted.
Saves to your PUZL account - edit_account_recipeChange one of your account's recipes.
Saves to your PUZL account - find_recipesFind ready-made prompts (recipes) that match what you want to do.
- get_recipeRead one recipe in full.
- list_account_recipe_historyShow the earlier versions of one of your account's recipes.
- save_account_recipeSave a new recipe for your account.
Saves to your PUZL account
Inventory & Equipment
- list_equipmentList the equipment held at a location.
Finance
- invoice_spend_by_vendorAdd up invoice spend by vendor over a date range.
Customer Sites
- list_site_leadsList form submissions (leads) sent from the account's websites, newest first.
- site_add_asset_from_fileCopy an image from the account's PUZL Files library into an open release.
Saves to your PUZL account - site_add_asset_from_urlFetches an image server-side from an allowed source and adds it to an open release, without carrying its bytes through this tool call's arguments or return value.
Saves to your PUZL account - site_check_urlGETs one page from the site's own live domain or its preview host — nothing else.
- site_checklistOrdered guided-setup checklist for one site: account link, lead recipients, form wiring, release checks, publish status, and custom domain (tenant sites only — a legacy per-site-distribution site reports this step blocked).
- site_delete_fileRemove one file from an open release.
Saves to your PUZL account - site_domain_statusLive domain status for a tenant site, read from CloudFront, not cached: the default <slug>.sites.try-neon.com address (reports "active" — the shared wildcard cert covers it automatically, nothing to wait on), and the customer's own domain if one has been added, with its activation status and a derived certificate_status ("issued" once active, else "pending").
- site_edit_fileEdits one existing text file in an open release by find-and-replace, without sending the whole file.
Saves to your PUZL account - site_errors4xx/5xx error counts and WAF blocks for a site's live traffic over the last `hours` hours (default 24).
- site_form_endpointThe URL a site's HTML forms must post to so submissions are stored as leads (POST, same-origin credentials not required).
- site_generate_preview_cardRenders a 1200x630 PNG link-preview card for one page (or, with *page* omitted, every HTML page in the release) from that page's own headline (its first <h1>, or an existing og:title), the site's name, its :root CSS colours where the page declares any, and its domain.
Saves to your PUZL account - site_get_fileReturns one file's text content, or an image's metadata (type, size, dimensions) without its bytes.
- site_import_single_fileSplits a single-file HTML upload into separate page, image and structure files in an open release, and points every form on the resulting page at this site's own lead-intake endpoint before writing it, so an imported page keeps posting to where it originally came from only until this runs.
Saves to your PUZL account - site_invalidatePurges the CDN's cached copies for a site so new content shows up immediately, without waiting for cache-control to expire.
Saves to your PUZL account - site_listSites the caller may edit: id, slug, name, status, live release id, and the caller's role on each.
- site_list_filesLists a release's files: path, type, size.
- site_progressOne site's guided-setup progress in plain language: an overall summary, each step's state, who acts on it (the customer, NeonData, or the customer's own DNS host), and a plain next action.
- site_publishMakes a finished, passing release live on the site.
Saves to your PUZL account - site_put_fileAdd or replace a whole small text file (a page, a stylesheet, a script, an SVG) in an open release.
Saves to your PUZL account - site_redirects_approveApproves the given redirect ids, or every currently-proposed one with all_proposed=True, and makes each one live.
Saves to your PUZL account - site_redirects_denyDenies the given redirect ids, or every currently-proposed one with all_proposed=True.
Saves to your PUZL account - site_redirects_discoverFinds pages from a site's previous address that might need a redirect on the new one: reads the old address's robots.txt for its sitemap (falling back to common sitemap locations), follows sitemap indexes, and checks each old page against what the live release actually serves.
Saves to your PUZL account - site_redirects_listLists every redirect proposed on this site, whatever its state (proposed, approved, denied), with who proposed or decided it and when.
- site_redirects_proposeProposes one or more 301 redirects for this site — each a from_path/to_path same-site path pair.
Saves to your PUZL account - site_redirects_removeDeletes the given redirects outright (any state) and removes them from service if they were approved.
Saves to your PUZL account - site_release_finishCloses an open release and checks it: file types, no server-side code, size caps, a secret scan, forms posting only to an allowed endpoint, broken links, a favicon, link-preview tags, render-blocking third-party stylesheets (e.g.
Saves to your PUZL account - site_release_startOpen a new release on a site.
Saves to your PUZL account - site_reply_email_setTurns the visitor thank-you reply on or off for this site's own forms, and optionally sets its subject and body.
Saves to your PUZL account - site_rollbackPoints the site back at an earlier release that was itself live before.
Saves to your PUZL account - site_set_lead_recipientsSet which email addresses form submissions on this site are forwarded to.
Saves to your PUZL account - site_statusThe site's current status: slug, live release id, and status, plus — once a live address has been provisioned — the distribution id, domain (or, for a tenant site, distribution_tenant_id and tenant_domain), and CloudFront's own rollout status ("InProgress" or "Deployed"); cdn_status is null for a site with no distribution or tenant yet.
- site_wire_formsPoints every form on an open release's HTML pages at this site's own lead-intake address and adds the hidden honeypot field to a form missing one.
Saves to your PUZL account - update_site_leadMove a website lead between active and spam — the same two states the Leads page's Spam tab moves a row between.
Saves to your PUZL account
Group Accounts
- group_shared_filesList files shared into the current group account.
- revoke_group_shareRevoke a group share.
Saves to your PUZL account - share_file_to_groupShare one of your files into a group account you and the file's account both belong to.
Saves to your PUZL account
Personal Preferences
- get_preferencesReturn all preferences set for the authenticated user in this account.
- set_preferenceSave one of your preferences for this account.
Saves to your PUZL account
Other
- query_financialsRead QuickBooks reports for the account. Account admins only.
Questions? Email support@puzldata.com.