Skip to main content

Architecture

The Adspirer MCP server uses a shared-skills architecture for consistent behavior across all AI clients.

System Overview

Shared Skills

Skills are defined as Markdown templates in shared/skills/. Each skill contains:
  • SKILL.md — The skill definition with instructions and workflow steps
  • references/ — Supporting documents and examples
Skills are the source of truth — IDE-specific plugins generate their implementations from these shared templates.

Plugin System

Each IDE gets a tailored plugin that adapts the shared skills to its environment:
IDEPlugin LocationAdapts For
Claude Codeplugins/claude-code/Slash commands, CLAUDE.md, subagents
Cursorplugins/cursor/.cursor/rules, MCP config
Codexplugins/codex/config.toml, agent instructions
OpenClawplugins/openclaw/Plugin manifest, commands

Server Registry

The MCP server is registered at registry.modelcontextprotocol.io as com.adspirer/ads. The server.json file contains the registry manifest with server metadata, capabilities, and authentication requirements.
Last modified on March 23, 2026