> ## Documentation Index > Fetch the complete documentation index at: https://promptwatch.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Tools > Every tool exposed by the Promptwatch MCP server, grouped by what it does The Promptwatch MCP server exposes the tools below. You usually don’t need tool names, just ask in plain English. Use this page when you’re writing a skill, debugging a workflow, or want to know exactly what the server can do. Most are **read-only** (they only query your data); a smaller set **create**, **update**, or **delete** records and are marked accordingly. Every tool carries machine-readable annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`) so MCP clients can surface and gate them appropriately. All tools are scoped to the organization and project(s) tied to your API key or OAuth session and require a valid `projectId` (except `listProjects`, `createProject`, and `listModels`). ## Projects & models | Tool | Access | Description | | --------------- | ------ | -------------------------------------------------------------------------- | | `listProjects` | Read | List all projects in your organization with their ids, names, and websites | | `createProject` | Create | Create a new project (a brand/website to track) | | `listModels` | Read | List the LLM models Promptwatch can monitor | ## Monitors | Tool | Access | Description | | --------------- | ------ | --------------------------------------------------------------------------------- | | `listMonitors` | Read | List monitors (recurring prompt-run configurations) with their visibility metrics | | `getMonitor` | Read | Get a single monitor's configuration and metrics | | `createMonitor` | Create | Create a new monitor for selected models, location, and persona | | `updateMonitor` | Update | Update a monitor's name, models, active state, or location | | `deleteMonitor` | Delete | Delete a monitor and stop its scheduled runs | ## Prompts | Tool | Access | Description | | ------------------------- | ------ | --------------------------------------------------------- | | `listPrompts` | Read | List tracked prompts with pagination, search, and filters | | `getPrompt` | Read | Get a single prompt by ID | | `createPrompt` | Create | Create a new prompt to track in a monitor | | `createPromptsBulk` | Create | Create multiple prompts at once | | `deletePrompt` | Delete | Delete a prompt | | `deletePromptsBulk` | Delete | Delete multiple prompts | | `activatePrompts` | Update | Activate prompts so they run in monitors | | `deactivatePrompts` | Update | Deactivate prompts (history is kept) | | `attachTagsToPrompt` | Update | Attach tags to a prompt | | `attachTagsToPromptsBulk` | Update | Attach tags to multiple prompts | ## Visibility & sentiment | Tool | Access | Description | | ------------------------- | ------ | ------------------------------------------------------------------- | | `getVisibilityTimeSeries` | Read | Brand visibility score over time, with model/prompt/monitor filters | | `getSentimentTimeSeries` | Read | Brand sentiment score over time, with model/prompt/monitor filters | ## Citations | Tool | Access | Description | | ---------------------------- | ------ | ----------------------------------------------------------------------- | | `getCitations` | Read | Citation analytics: domain/URL frequency, traffic, and authority scores | | `getSelfCitationFrequency` | Read | How often AI answers cite your own domain over time | | `getCitationDomainsOverTime` | Read | Citation counts per cited domain over time | | `getCitationRankAnalysis` | Read | Your domain's rank among all cited domains over time | | `getCitationTopPages` | Read | Most-cited pages with citation counts and average rank | | `getCitationLlmSources` | Read | Top cited sources with per-source citation stats | | `getCitationDomainsByLlm` | Read | Domain citations broken down by LLM model | ## Responses | Tool | Access | Description | | ---------------------------------- | ------ | --------------------------------------------------------- | | `listResponses` | Read | List collected AI responses with pagination and filters | | `getResponse` | Read | Get a single AI response with its full text and citations | | `getResponsesSummary` | Read | Total responses and brand mentions for a date range | | `getMentionsTimeSeries` | Read | Brand and competitor mentions over time | | `getTopCompetitors` | Read | Competitors mentioned most in AI responses | | `getResponseSentimentDistribution` | Read | Positive/neutral/negative split of responses | | `getResponseSentimentTimeSeries` | Read | Response sentiment over time | ## Brands & competitors | Tool | Access | Description | | ---------------------------- | ------ | ------------------------------------------------------------------- | | `listBrands` | Read | List brands detected in AI answers (own brand, competitors, others) | | `createBrand` | Create | Create or link a brand with its relation to your brand | | `updateBrand` | Update | Update a brand's relation (e.g. competitor, ignored) | | `getBrandVisibilityOverTime` | Read | Visibility over time for all tracked brands, for comparison | | `getCompetitorHeatmap` | Read | Competitor visibility heatmap per LLM model | ## Content gaps & content | Tool | Access | Description | | ------------------------------ | ------ | ------------------------------------------------------------------------- | | `getContentGapStats` | Read | How well your site content covers the topics your prompts ask about | | `listContentGapPrompts` | Read | Prompts with content-coverage scores, to find gaps | | `getContentGapLatest` | Read | Latest content-coverage analysis for a prompt | | `getContentGapRecommendations` | Read | Recommendations for closing a prompt's coverage gap | | `listQueryFanouts` | Read | Prompts with ChatGPT query-fanout keywords (sub-queries ChatGPT searches) | | `listContent` | Read | List AI-generated content documents (summary fields) | | `getContent` | Read | Get a content document including its full markdown body | | `createContent` | Create | Generate new content or optimize an existing page | ## Tags & personas | Tool | Access | Description | | --------------- | ------ | ---------------------------------------------------- | | `listTags` | Read | List tags with prompt counts | | `createTags` | Create | Create tags for grouping prompts | | `renameTag` | Update | Rename a tag | | `deleteTag` | Delete | Delete a tag | | `listPersonas` | Read | List personas (audience profiles) | | `getPersona` | Read | Get a single persona | | `createPersona` | Create | Create a persona for monitors and content generation | | `updatePersona` | Update | Update a persona | | `deletePersona` | Delete | Delete a persona | ## Action items | Tool | Access | Description | | ------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------- | | `listActionItems` | Read | List paginated GEO action items (page/size; defaults to non-dismissed page 1, size 50; pass status=dismissed for dismissed actions) | | `updateActionItemStatus` | Update | Update an action item status (accept, dismiss, complete, etc.) | ## Site health | Tool | Access | Description | | --------------- | ------ | -------------------------------------------------------------------------------------------------------- | | `getSiteHealth` | Read | Pages with SEO issues (missing title/description, H1 problems, thin content); optional issueTypes filter | ## Sitemap | Tool | Access | Description | | -------------------- | ------ | --------------------------------------- | | `getSitemapProgress` | Read | Sitemap crawl progress for your website | ## Traffic analytics | Tool | Access | Description | | ------------------------- | ------ | --------------------------------------------------------------------------- | | `getVisitorTotal` | Read | Total visitor counts over time | | `getVisitorTrend` | Read | Visitor trends by referrer over time (see AI-driven traffic) | | `getVisitorReferrerStats` | Read | Referrer stats with period-over-period changes | | `getVisitorTopPages` | Read | Top pages by visits, filterable to AI-referred traffic | | `getVisitorTopSources` | Read | Top visitor sources | | `getVisitorTopLocations` | Read | Top visitor locations | | `getVisitorTopDevices` | Read | Top visitor devices | | `getVisitorTopBrowsers` | Read | Top visitor browsers | | `getCrawlerTrend` | Read | AI crawler (GPTBot, ClaudeBot, ...) activity over time from server/CDN logs | | `getTopCrawlerPages` | Read | Pages AI crawlers request most |