Tap

Save a reviewable TV or radio buy composition from submitted, orderable response options and exact weekly spot quantities. Use origin generated with the matching strategy for an assembleBroadcastBuy recommendation; use origin manual with a null strategy for a buyer-authored mix. This saves an internal candidate only. It does not create or send Orders. Creates a saved planning option only when the user asks to save a buy. Do not use for a request to book media or pay suppliers: neither capability exists in this plugin. A recommendation alone should use assembleBroadcastBuy without saving.

createBroadcastBuyComposition

Create one reusable active Product under a buyer-owned Client when both Product Code and Name are grounded and no active match exists. Product Code is the second CPE segment; Estimate Number belongs to the Campaign. Returns productPublicId for setPlanCommercialIdentity.

createClientProduct

Create a buyer-owned draft Campaign from grounded campaign facts. Requires valid flightStart and flightEnd dates. Ask the buyer for missing dates before calling this tool; never invent dates or create an undated Campaign shell. Set mediaTypes to the recommended Campaign channels, even before their RFPs or allocations exist. Include every known target market by directory name. Tap resolves and assigns the canonical markets during creation. Include grounded initial audienceLabels to create the canonical audiences in the same call. Use their returned IDs for RFP goals. When brandName is supplied, Tap reuses an exact owned Client or creates and assigns it; website is optional. This creates planning context only, not an RFP. Creates campaign context. Supplying a website for a newly created client also starts background public-website enrichment.

createPlan

Add an active reusable standard age/gender audience to an existing Campaign and return its canonical ID. For a new Campaign, supply audienceLabels to createPlan. Use a buyer-supplied definition or one supported by grounded campaign context. If several definitions are plausible and the choice would materially change the buy, ask the buyer. Use the returned ID in RFP selections and weekly goals.

createPlanAudience

Permanently delete explicitly requested buyer-owned Clients/brands by brandPublicId. Deletes dependent products, folders, memories and website, asset and saved-file metadata; linked Campaigns retain briefs but lose the Client. Can also delete supplier-owned routing rules that reference the Client. It does not send supplier messages. Deletes specifically identified client records and dependent products, folders, memories, website, asset and saved-file metadata. Linked campaigns lose client associations. Can also delete supplier-owned routing rules referencing the client. Requires approval. Cannot delete all client data, campaigns, RFPs, responses, orders or organizations. Explain those limits instead of offering broad deletion.

deleteBrands

Delete a wrong or outdated saved memory by memoryPublicId. Requires approval before permanently deleting the saved memory and its links.

forgetMemory

Read a complete buyer-owned RFP: working draft, revision, recipients, completion issues, and version. Each mutation validates the current lifecycle state and version.

getBroadcastRfp

Read one Campaign’s RFP goals, submitted response menus, Draft/Ordered/Confirmed Orders, and submitted Post-Buy delivery summaries. Order totals and warnings describe projections, not actual delivery. Actual delivery comes only from submittedPostBuy. Creative and correspondence are not checked by this tool; do not infer completion or that nothing is waiting from their absence. Read-only; it never saves quantities or sends an Order.

getBroadcastBuyingContext

Read the buyer-visible station directory by market and medium. Use it to resolve market intent and TV/radio coverage before drafting.

getBroadcastInventoryOverview

Read public collateral for one buyer-visible station, including media kits, specifications, and case studies. This is read-only; cite grounded source material and never infer missing commercial facts.

getBroadcastPropertyPublicFiles

Read the enabled U.S. Census ACS profile snapshot for up to 20 named Tap markets. Returns population, household, age, income, poverty, education, broadband, and home-ownership measures with the dataset year. Use this as directional market and audience planning evidence, not as measured media reach or supplier inventory.

getCensusMarketInsights

Return the authenticated Tap buyer and selected buyer organization for this connection. Use this to confirm which account an MCP action will affect.

getCurrentIdentity

Read canonical Campaign context for RFP work: objective, selected media workstreams, optional commercial identity, active Product options, flight, active Campaign-owned audiences, target markets with canonical market-local daypart presets, existing RFP lifecycle states, and explicit timezone resolution status. Treat each returned RFP state and sentAt as authoritative; a sent RFP is not an unsent draft.

getPlanContext

Link two saved memories with a directed edge and optional relation label. Use when one fact explains or relates to another, not to replace an active preference.

linkMemories

List the saved TV or radio buy compositions for one Campaign, including exact option selections, weekly quantities, totals, source state, and version. Use this before editing or ordering a saved composition. Read-only; it never creates or sends an Order.

listBroadcastBuyCompositions

List every buyer-visible TV or radio station matching market names and media types. Use this for requests to name stations, call signs, listing owners, or the underlying directory without requiring a Campaign or RFP. RFP stageability is reported separately from directory visibility. Read-only; it never creates a Campaign or RFP and never contacts a supplier.

listBroadcastDirectoryProperties

List the complete buyer-visible station set eligible for one RFP’s exact market and medium. Use after creating an RFP draft to make its grounded recipient recommendation, or when the buyer asks to inspect or compare the underlying supplier directory. Read-only; it never selects or contacts a property.

listBroadcastRecipientCandidates

List one Campaign’s broadcast RFP summaries and calculated goal budgets. Use getBroadcastRfp when the complete current artifact is needed.

listBroadcastRfps

List the authenticated buyer organization's Campaigns. Use state: null to include all lifecycle states in one read; filter only when requested. Includes brand, budget, flight, and media to identify the right Campaign. This is read-only.

listMyPlans

Read one complete published Tap user guide page after searchUserGuide identifies the relevant page. Use the returned page as the authoritative source and cite its URL.

readUserGuidePage

Remove one option from an editable saved buy composition using its latest version. This changes only the internal composition and does not withdraw or change any Order. Deletes the selected composition line and its saved weekly quantities. Requires approval; adding the option again does not restore the quantities.

removeBroadcastBuyCompositionAvail

Build a cited read-only dossier for one US AM/FM station using a Tap property or explicit call sign and band. Returns canonical identity, validated claims, ranked sources, gaps, and conflicts. Searches supplier public files before official and industry web evidence. Retrieves public station evidence and returns a cited dossier, using expiring research caches. Does not edit buyer or supplier records, publish content or contact station representatives.

researchStation

Resend a staged material revision to the open RFP Exchanges. Call only when requested. The command validates the current state and version. Requires approval before another external supplier notification.

resendBroadcastRfp

Resolve a response deadline date to the end of that calendar day using canonical Campaign timezone data. Read-only; it does not save the RFP.

resolveBroadcastRfpDeadline

Save the complete current RFP draft with its expected version. Read first, preserve unchanged fields, omit Campaign-derived clientProductEstimate, and keep intentional completion gaps. Returns the saved RFP artifact and never distributes it. Replaces existing draft content and can remove omitted draft details. Requires approval. Nothing is sent.

saveBroadcastRfpDraft

Save exact integer spot quantities for option weeks in an editable buy composition using its latest version. Include every option week the buyer wants to change, including zero to clear a week. This changes only the internal composition and does not create or send Orders. Overwrites saved weekly spot quantities, including zero to clear them. Requires approval. Does not book media.

saveBroadcastBuyCompositionQuantities

Save one short durable fact: user scope for this person, team for the organization, or brand with brandPublicId. Use replacesMemoryPublicId when updating a recalled preference so only one active note remains. Give it a short title and useful tags. Requires approval. When replacesMemoryPublicId is supplied, replaces that memory in place, including supplied title and tags.

saveMemory

Search buyer-visible saved files such as briefs, decks, spreadsheets, and brand documents. Each hit includes citationMarkdown; place it directly after every claim that uses the hit. Retrieves authorized saved-file excerpts using configured external AI processors for embedding and reranking. It does not create, edit or delete saved files.

searchContextFiles

Search Tap’s authenticated supplier-rep directory by person name, station, supplier, or role. Use this when a buyer asks who to contact or wants a connection at a station or supplier. Returns only discoverable profile fields. Email and phone are never returned.

searchSupplierReps

Search Tap’s public user guide for authoritative product instructions and how-to answers. Use this before answering questions about how to use Tap, then cite the returned guide pages.

searchUserGuide

Choose the final reviewed buy composition for one campaign and broadcast medium using its latest version. This replaces any other selected candidate for that campaign and medium, but it still does not create or send Orders. Replaces the currently selected planning option for this campaign and medium. Requires approval. Use only for a requested selection; this does not create supplier orders, book media, or pay suppliers. Never use as a substitute for booking or payment.

selectBroadcastBuyComposition

Send a complete RFP draft to its selected stations. Pass propertyId to send only to that selected property. Call only when the buyer requests Send. The command validates the current state and version. Requires approval before contacting the selected suppliers. Issued delivery cannot be recalled.

sendBroadcastRfp

Set or clear a Campaign's Client, active Product, and digit-only Estimate Number. Use grounded IDs from current Campaign context and preserve Estimate Number leading zeroes. These fields are optional and do not block RFP work. Replaces the campaign client, product and estimate identity. Changing the client also clears the campaign folder association. Requires approval.

setPlanCommercialIdentity

Stage a complete material revision for a sent RFP. Read first, preserve unchanged content, use the current revision as base, and omit Campaign-derived clientProductEstimate. The command validates the current state and version. This does not resend. Creates a separate staged revision and retains the issued revision. Nothing is sent.

stageBroadcastRfpMaterialRevision

Persist the buyer agent’s complete, editable station recommendation for one RFP draft. Submit one on/off row for every eligible candidate at the current RFP version, with a short buyer-readable reason for each. The server reloads the directory and rejects incomplete or language-conflicting recommendations. A conflicting or unverified primaryLanguage cannot satisfy an explicit language requirement. This tool never distributes the RFP. Replaces the staged recipient list and removes deselected recipients. Requires approval. No station is contacted.

stageBroadcastRfpRecipients

Patch grounded Campaign header facts and, when supplied, replace its target markets using directory names. Pass an empty marketNames list only when the buyer wants to clear all target markets. This does not modify RFP goal budgets, flights, deadlines, or recipients, Campaign-owned audiences, responses, or Orders. Use adjustBroadcastCampaignDrafts for campaign-wide budget, flight, or deadline changes so the header and unsent drafts save together. Replaces supplied campaign fields and market selections, including explicit clears. Requires approval before changing saved data.

updatePlan

Change how often the current buyer receives their personal Tap reports. For weekly reports, set the requested weekday. This preserves whether reports and email notifications are enabled, the delivery time, timezone, and selected report sections. Replaces your saved report cadence and, when email notifications are enabled, changes future email delivery frequency. Requires approval. It preserves recipients and enabled settings and sends no report immediately.

updateTapReportSchedule