> This page is for Workforce. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Peec AI **Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow. ## Sample use cases * Run a daily competitive scan across our top 5 competitors and post a digest in #marketing. * Pull the share-of-voice trend for our brand vs. the category over the last 90 days. * Find topics where our content is missing from AI search results. ## Available Tools #### list_brands List tracked brands in a Peec project. Supports offset pagination. Returns brand IDs, names, domains, aliases, and... #### create_brand Create a new tracked brand. Provide name, domains, aliases, regex pattern, or color. The brand becomes available for... #### update_brand Update a brand's name, domains, aliases, regex, or color. Modifying name, regex, or aliases triggers metric... #### delete_brand Soft-delete a brand. The brand is removed from the project but historical data is retained. Use list_brands to find... #### list_brand_suggestions List AI-generated brand suggestions for a project. Each suggestion includes a name, domains, and the count of chats... #### accept_brand_suggestion Accept an AI-generated brand suggestion. The suggestion becomes a tracked brand. Use list_brand_suggestions to find... #### reject_brand_suggestion Permanently reject an AI-generated brand suggestion. The suggestion is discarded. Use list_brand_suggestions to find... #### list_chats List chats (AI model responses) for a project. Filter by date range, brand_id, prompt_id, or model_channel_id. Returns... #### get_chat Get full content of a chat including the prompt, model channel, all messages (user + assistant), cited source URLs... #### list_model_channels List available AI model channels (e.g. 'openai-0', 'perplexity-1') and the model each currently points at. Channels are... #### list_projects List Peec AI projects available to the API key. Requires a company-scoped API key — project-scoped keys will get a 403... #### get_project_profile Get the brand profile for a project. Returns occupation, industry, brand presentation, products and services, target... #### set_project_profile Replace the entire brand profile for a project. WARNING: this is a full replacement — every field is required. Returns... #### list_prompts List configured prompts that Peec runs against AI models. Filter by topic_id or tag_id. Each prompt includes its text... #### create_prompt Create a new prompt to track. Required: text (1-200 chars) and ISO 3166-1 alpha-2 country_code. Optionally attach... #### update_prompt Update a prompt's topic_id or tag_ids. Pass null topic_id to detach. Use list_prompts to find valid IDs. #### delete_prompt Soft-delete a prompt. Cascades to delete related chats. Use list_prompts to find valid IDs. #### list_prompt_suggestions List AI-generated prompt suggestions. Optionally filter by topic_id. Use accept_prompt_suggestion or... #### accept_prompt_suggestion Accept an AI-generated prompt suggestion. The suggestion becomes a configured prompt. Use list_prompt_suggestions to... #### reject_prompt_suggestion Permanently reject an AI-generated prompt suggestion. Use list_prompt_suggestions to find valid IDs. #### list_fanout_search_queries List fanout search queries — the underlying search-style queries that AI models issued while answering tracked prompts... #### list_fanout_shopping_queries List fanout shopping queries — the product-style queries that AI models issued while answering tracked prompts. Each... #### get_brands_report Get a brand-level report with metrics (visibility, sentiment, position, mention_count, share_of_voice) over a date... #### get_domains_report Get a source-domain report with metrics (citation_rate, retrieval_count, citation_count) over a date range. Identifies... #### get_urls_report Get a source-URL report with metrics (citation_rate, retrieval_count, citation_count) over a date range. Identifies... #### get_url_content Fetch the scraped markdown content of a source URL Peec has indexed. Returns title, domain, content, truncation flag... #### list_tags List tags in a Peec project. Tags are used to group prompts. Returns tag IDs, names, and colors with offset pagination. #### create_tag Create a new tag for grouping prompts. Required: name. Optional color (defaults to 'gray'). Valid colors: gray, red... #### update_tag Update a tag's name and/or color. Use list_tags to find valid IDs. #### delete_tag Soft-delete a tag. Use list_tags to find valid IDs. #### list_topics List topics in a Peec project. Topics are used to organize prompts. Returns topic IDs and names with offset pagination. #### create_topic Create a new topic to organize prompts. Required: name (1-64 chars). Optionally provide an ISO 3166-1 alpha-2... #### update_topic Update a topic's name (1-64 chars). Use list_topics to find valid IDs. #### delete_topic Delete a topic. Use list_topics to find valid IDs. #### list_topic_suggestions List AI-generated topic suggestions. Use accept_topic_suggestion or reject_topic_suggestion to triage. #### accept_topic_suggestion Accept an AI-generated topic suggestion. The suggestion becomes a tracked topic. Use list_topic_suggestions to find... #### reject_topic_suggestion Permanently reject an AI-generated topic suggestion. Use list_topic_suggestions to find valid IDs.