How to Build a Claude Plugin with Peec AI MCP
Last updated: 28 May 2026
Short answer: a Claude plugin should not replace the Peec AI MCP server. The plugin should package the operating instructions, workflows, guardrails, examples, and QA checks. Peec AI MCP remains the live data connector.

Think of the plugin as the agent's playbook. It tells Claude how to use Peec data: default date ranges, metric formatting, action categories, confirmation rules, output templates, and what counts as a finished report. MCP supplies the actual project data.
Plugin anatomy
| File or section | Purpose |
|---|---|
| Manifest | Names the plugin and declares what it does |
| Skill instructions | Teach Claude the Peec reporting workflow |
| Examples | Show weekly pulse, source audit, and blog optimisation prompts |
| Guardrails | No secrets, no raw IDs, no writes without approval |
| QA checklist | Schema, links, images, source ledger, desktop/mobile preview |
What the plugin should teach Claude
- Start by listing Peec projects and resolving the right one by name.
- Resolve brands, topics, tags, and model channels before analysis.
- Use 30 days for strategy, 7 days for weekly reporting.
- Break down by engine and topic, not just aggregate.
- Display visibility and share of voice as percentages.
- Display retrieval rate and citation rate as rates.
- Group actions into owned, editorial, reference, and UGC work.
- Confirm before using any write or delete tool.
Example plugin workflow
Run a Peec source authority audit for <project>.
Find gaps where competitors are cited and our domain is not.
Return: executive summary, top engines, top topics, source domains, URLs,
recommended owned-page updates, editorial targets, UGC opportunities,
and the exact human approvals needed before any mutation.
Plugin versus connector
The connector/MCP server answers "what data can Claude access?" The plugin answers "how should Claude behave with that data?" Mixing those boundaries is risky. Do not hardcode Peec tokens in a plugin. Do not assume every workspace has the same project names. Do not hide destructive actions behind vague wording.
For Schmitdy, this plugin pattern would sit beside Claude Code implementation, Cowork reporting, and the AI Search audit.
Source and fact ledger
- Peec AI MCP tools reference:
https://docs.peec.ai/mcp/tools - Peec AI MCP setup guide:
https://docs.peec.ai/mcp/setup - Claude connectors directory docs:
https://claude.com/docs/connectors/directory
Frequently Asked Questions

Founder, Schmitdy
Marco builds AI search growth systems that turn prompts, sources, content, and agents into pipeline for B2B teams.
Related Articles

Peec AI MCP Deep Dive: How AI Search Data Becomes Agentic GEO Execution
Peec AI MCP turns AI visibility data into an agent-readable data layer. The winning workflow is not dashboard replacement; it is measured, source-led execution.

How to Build Claude Agents with Peec AI MCP
Connect Claude to Peec AI through MCP, then turn visibility, source, and competitor data into a repeatable AI search growth agent.

How to Build Claude Agents with Peec AI MCP: The AI Search Blog Optimiser Example
Use the AI Search Blog Optimiser as the public example: Peec reads the market, Claude creates the evidence, and the harness decides what ships.
See where AI search is already choosing your competitors
Request the free AI Search audit and get the prompts, source gaps, and next actions that matter for pipeline.
