> This page is for Agent Handler. > 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.