The server exposes 14 tools in the prominara_ namespace. Read tools need the read permission, act tools need write. This table is generated from the server’s own catalog, so it cannot drift from what your agent sees.
Read tools
List sites
prominara_list_sites
Lists the sites (brands) in the connected Prominara organization with domain, brand name, latest audit score, last scan date and active prompt count. Call this first to learn which site identifiers to use with the other tools; sites can be addressed by domain or id.
read permissionNo quota
Visibility overview
prominara_visibility_overview
Returns AI-search visibility for one site over a window (default 30 days): citation and mention rates with confidence intervals, per-platform breakdown, trend versus the previous window, and the competitor ranking. Rates use earned prompts and successful checks only. Use concise for headline numbers, detailed for per-prompt rows.
read permissionNo quota
List tracked prompts
prominara_list_prompts
Lists the prompts tracked for a site with category, panel (organic, branded, competitive), active state and the latest result per platform. Filter by status or search text. Use it to find prompt ids before calling get_answers, run_check or set_prompt_active.
read permissionNo quota
Get latest AI answers
prominara_get_answers
Returns the latest recorded AI answers for one prompt: per platform whether the brand was mentioned or cited, the sources the answer used, position and sentiment, plus check history. Detailed mode includes the answer text, returned as untrusted third-party content.
read permissionNo quota
List missions
prominara_list_missions
Lists the prioritized missions for a site: for each tracked prompt, the current visibility, the page that should own the answer (or the gap), the source gap and the next best action, ranked by priority. Filter by priority, status or intent.
read permissionNo quota
Sources intelligence
prominara_sources
Returns the off-site sources behind AI answers for a site. Views: domains (which sites AI answers cite and whether they mention the brand), citations (individual cited pages), opportunities (ranked places to earn a citation) and accuracy (factual issues found in answers about the brand). It reads records already stored for the site and does not fetch or modify anything.
read permissionNo quota
Measurement verdicts
prominara_measurement
Returns the impact measurement for content changes logged on a site: per change, the observation window status and the verdict (likely lift, no effect, still collecting) with its probability, plus the program-level before/after comparison when enough data exists. Pass a change id for the detail of one change. Verdict wording is the product's own and does not claim causation beyond what the design supports.
read permissionNo quota
Suggest prompts to track
prominara_suggest_prompts
Returns suggested prompts for a site from the coverage matrix (organic, branded and competitive panels across buyer-journey stages), with a recommended set for the plan's slots. It may reuse cached suggestions or send stored site context to the configured AI provider to draft a fresh response without web search, but does not save suggestions or tracked prompts; use prominara_create_prompts to keep selected prompts.
read permissionNo quota
Plan and usage
prominara_usage
Returns the organization's plan, monthly check quota used and remaining with the reset date, tracked prompt slots used, website and client-workspace allowances, platform slots and trial state. Call it before running checks or creating prompts to know what fits.
read permissionNo quota
Act tools
Create tracked prompts
prominara_create_prompts
Adds up to 20 prompts to track for a site and may queue initial checks that send the prompts to enabled AI/search providers and search the public web; checks consume monthly quota and results are stored privately. Duplicates of existing prompts are skipped, prompts beyond the plan's slots are skipped and reported, and platforms are clamped to the plan. Returns what was created, what was skipped and why.
write permissionPrompt slots
Run a check now
prominara_run_check
Runs a fresh visibility check for up to 10 prompts across the site's enabled AI platforms, sending prompt text to AI/search providers that may search the public web and storing new results privately. Each check counts against the monthly quota. Prompts with a check already in progress are skipped and reported. Results arrive asynchronously; read them with get_answers after a minute or two.
write permissionCheck quota
Log a shipped content change
prominara_log_content_change
Records a shipped content change with its release date and summary. When prompt_id is supplied, links the page as that prompt’s primary page (replacing any previous primary link), marks its mission shipped, freezes the measurement cohort, opens an experiment and queues a public-page recrawl. Without prompt_id, records only the change and does not recrawl or open an experiment. While the measurement window is open (35 days), scheduled checks of the linked prompt send extra repeated and reworded runs to the enabled AI providers, and the page text is sent to an AI model to extract its key claims. A repeat call reuses the existing change record but runs the page linking again. Does not edit or publish the live website.
write permissionOpens a measurement window
Update mission status
prominara_update_mission
Overwrites the status and snooze/dismissal dates of one mission (per prompt) on a site: new, in_progress, shipped, measuring, snoozed (with a date) or dismissed. Use shipped after the page work is live, or log_content_change which does it automatically.
write permissionNo quota
Enable or disable prompts
prominara_set_prompt_active
Turns up to 50 tracked prompts on or off and sets or clears when each is next checked. Activated prompts become eligible for scheduled checks, which send the prompt text to AI/search providers that may search the public web and consume monthly check quota when they run; the call itself runs no check. Deactivated prompts stop being checked and free a slot, and their history is kept. Activating re-checks the plan's prompt slots and reports any that do not fit.
write permissionPrompt slots
Addressing sites and prompts
Sites can be named by domain or by id. Call the list-sites tool first if you are not sure which identifier to use. Prompts are addressed by id, which the list-prompts tool returns.
Concise and detailed output
Tools whose output can be large accept a response format. Concise returns headline numbers and top rows, detailed adds per-prompt detail. Recorded answer text is only returned in detailed mode, truncated, and wrapped as untrusted third-party content so the calling agent treats it as evidence rather than instructions.
Limits per call
- Create prompts: up to 20 per call
- Run a check: up to 10 prompts per call
- Enable or disable prompts: up to 50 ids per call
- List tools: a limit of at most 100 rows
Errors say what to do next
A refusal is never a bare failure. Each one carries a code, a plain sentence your agent can relay, and the numbers behind it, so you learn which limit was reached and when it resets rather than watching a call fail silently. Partial success is reported too: if three of five prompts fit your plan, the tool creates three and says why the other two were skipped.