HiHello

Get card analytics for the authenticated HiHello account: card views, card saves, and contact adds, as totals and as a time series, plus a breakdown of views by channel (email signature, Apple Wallet, virtual background, widget, QR scan). Call this whenever the user asks how cards are performing over a period. Relative ranges like "last month" must be resolved to concrete dates before calling. Omit cardIds and templateIds to aggregate across all cards the account can see; call search_cards first to resolve card or person names into card IDs.

get_card_analytics

Get the full details of one business card: the person's name, title, company, department, headline, every contact field on the card (emails, phones, links, socials), the public URL, template, and status flags (public, paused, disabled, claim status). Call this when the user asks what is on a card, or when advice depends on card content (e.g. whether it has a call to action or a way to be contacted). Use search_cards first to resolve a card name to its cardId.

get_card

List the account's events (conferences, trade shows, meetups) with their dates, associated cards, and event analytics (card views, scans, connections). Call this to cross-reference card analytics against events: an event whose dates overlap a spike in views/saves, or whose cards match the cards being analyzed, likely explains the change. Use filterType PAST or ONGOING when analyzing a historical date range.

list_events

List the account's cards for a QR code export: person name, title, email, public card URL, and public_id. Call this when the user wants to export, download, or print their QR codes. Results are paged: keep calling with nextPage until it is null before presenting the list as complete. If you stop early, say the list is partial and how many of totalFound it covers. If you can write files, save each page as you receive it: append its cards to qr_codes.jsonl.part as JSON Lines (one card object per line), and rename it to qr_codes.jsonl once nextPage is null. Then build any CSV or image download from that file with code instead of retyping rows. Each QR code is a PNG at qrCodeUrlTemplate with {public_id} filled in; it needs no auth and also accepts size (small|normal|large) and logo_background (transparent|gray|white|cardcolor|nologo). If you can run code or fetch files, you can download the images from those URLs (keep concurrency modest, e.g. 5 at a time). If you cannot, give the user the URLs, or point them to the bulk "Download QR codes" action on the Cards page of the HiHello web app.

list_org_qr_codes

List the HiHello profiles (personal profile and organizations) this connection may act as. Every other tool takes an optional account_id from this list; without one it uses the default profile. Call this when the user names an organization, asks which profiles you can see, or before switching profiles. Returns accountId, name and isDefault for each.

list_profiles

Search the authenticated account's business cards by card name, person name, or job title. Call this to resolve a card or person the user mentioned into a cardId (e.g. before calling get_card_analytics), or to list the cards the account can see. Returns compact card summaries: cardId, card name, person name, title, company, publicId, publicUrl.

search_cards