Get Free AI Search audit — better than most paid audits
First-party Peec AI MCP visual used to explain a Claude plugin data-flow pattern

How to Build a Claude Plugin with Peec AI MCP

Marco Lobo
··7 min read
Share

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.

Peec AI MCP blog visual from Peec's first-party launch article

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 sectionPurpose
ManifestNames the plugin and declares what it does
Skill instructionsTeach Claude the Peec reporting workflow
ExamplesShow weekly pulse, source audit, and blog optimisation prompts
GuardrailsNo secrets, no raw IDs, no writes without approval
QA checklistSchema, 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

Marco Lobo
Marco Lobo

Founder, Schmitdy

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

Related Articles

First-party Peec AI MCP launch visual explaining how AI visibility data connects to agent workflows
AI GuidesPeec AIMCP

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.

Marco Lobo
Marco Lobo·31 May 2026·9 min read
Official Peec AI documentation animation showing Claude connecting to Peec AI through MCP
AI GuidesPeec AIMCP

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.

Marco Lobo
Marco Lobo·28 May 2026·8 min read
Official Peec AI documentation animation used as the visual source for the Peec AI MCP agent example
AI Search GrowthPeec AIClaude Agents

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.

Marco Lobo
Marco Lobo·28 May 2026·7 min read

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.