mcp-server-peecai

Get shopping/product queries that AI models generated when answering prompts. Returns product-related queries with associated product names. Useful for understanding product recommendations by AI models. Without date filters, returns data across all available dates. Empty results may indicate the project has no query data for the given time range or filters.

List AI chat interactions tracked by Peec AI. Returns up to limit results (default: 100). Recommended: use date filters to scope results. Returns chat IDs, prompt/model refs, and dates. Without date filters, returns all chats.

Deprecated: use list_model_channels instead. Model channels are stable identifiers (e.g. openai-0, perplexity-0) that persist when underlying models rotate. Returns model IDs and active status.

List suggested topics for a Peec AI project. Suggestions can be accepted to create topics or rejected to dismiss them.

Get URL analytics report: citation_count (total citations), retrievals (retrieval count), citation_rate. Classification values: HOMEPAGE, CATEGORY_PAGE, PRODUCT_PAGE, LISTICLE, COMPARISON, PROFILE, ALTERNATIVE, DISCUSSION, HOW_TO_GUIDE, ARTICLE, OTHER. Returns up to limit results (default: 100). Classification is filtered client-side after retrieval. Use filters array for server-side filtering by model, tag, topic, prompt, domain, URL, or country_code. Without date filters, returns data across all available dates. Empty results may indicate the project has no report data for the given time range or filters.

List search prompts for a Peec AI project. Returns prompt IDs, messages, tags, topics, locations, and search volume.

List suggested prompts for a Peec AI project. Suggestions can be accepted to create prompts or rejected to dismiss them.

Accept a prompt suggestion, creating a new prompt from it.

Reject a prompt suggestion.

Accept a topic suggestion, creating a new topic from it.

Reject a topic suggestion.

Accept a brand suggestion, converting it into a brand within the project.

Reject a brand suggestion, removing it from the project and preventing it from being re-suggested.

Get full content of a specific AI chat. Returns sources, brands mentioned, messages, queries, and products.

Get domain analytics report: retrieval_rate, citation_rate, and retrieved_percentage. Classification values: OWN, CORPORATE, COMPETITOR, EDITORIAL, REFERENCE, INSTITUTIONAL, UGC, OTHER. Returns up to limit results (default: 100). Classification is filtered client-side after retrieval. Use filters array for server-side filtering by model, tag, topic, prompt, domain, URL, or country_code. Without date filters, returns data across all available dates. Empty results may indicate the project has no report data for the given time range or filters.

List tracked brands for a Peec AI project. Returns brand IDs, names, and associated domains.

Create a new tag within a Peec AI project.

Update an existing tag's name or color.

Soft-delete a tag. This action is irreversible through the API.

Create a new topic within a Peec AI project.

Update an existing topic's name.

Soft-delete a topic. This action is irreversible through the API.

List model channels tracked by Peec AI. A model channel (e.g. openai-0, perplexity-0) is a stable identifier that groups one or more underlying models, so the channel ID remains constant even when the underlying model is rotated. Returns channel IDs, descriptions, the currently active model, and active status.

Get the scraped markdown content of a source URL. Use the URLs report (get_urls_report) to discover URLs. Returns markdown content plus metadata (title, domain, channel_title, classification, url_classification, content_length, truncated, content_updated_at). If stored content exceeds max_length, the response is truncated and truncated=true — re-request with a larger max_length to get more. Returns 404 if the URL is not tracked by the project.

Get search queries that AI models generated when answering prompts. Returns the actual search queries models used to find information. Useful for understanding how AI models research topics. Without date filters, returns data across all available dates. Empty results may indicate the project has no query data for the given time range or filters.

Create a new brand within a Peec AI project. Requires a brand name; optionally provide aliases, domains, regex pattern, and color.

Update an existing brand. Changing name, aliases, or regex triggers metric recalculation.

Soft-delete a brand. This action is irreversible through the API.

Create a new search prompt to monitor across AI models. Requires prompt text and country code.

Update prompt topic or tag assignments.

Soft-delete a prompt and its associated chats. This action is irreversible through the API.

Read the project's brand profile (description, industry, brand identity, target markets, audience distribution, products & services). Returns `{ profile: null }` if the project hasn't been profiled yet.

Replace the project's brand profile (full overwrite). All fields are required. `audienceDistribution` must sum to 100. Triggers a background refresh of prompt suggestions. Returns 403 while the project is in onboarding.

List topic groupings for a Peec AI project. Returns topic IDs and names.

Get brand analytics report per brand. Metrics: visibility (visibility_count/visibility_total), share_of_voice (0-1), mention_count, sentiment (0-100 scale, 50=neutral), position (avg rank when mentioned, lower=better). Returns up to limit results (default: 100). Use brand_id shortcut or filters array for server-side filtering. Supports date filtering and dimensional breakdowns. Without date filters, returns data across all available dates. Empty results may indicate the project has no report data for the given time range or filters — try a broader date range or fewer filters.

List category tags for a Peec AI project. Returns tag IDs and names.

List all Peec AI projects for the company. Returns project IDs, names, and statuses. Status values: CUSTOMER (active, ongoing monitoring), CUSTOMER_ENDED, PITCH (active demo), PITCH_ENDED (completed demo), TRIAL, TRIAL_ENDED, ONBOARDING, DELETED. Use CUSTOMER projects for current data.

List open brand suggestions for a Peec AI project. Suggestions can be accepted to convert into a brand or rejected to dismiss them.