Goodbarber Skills MCP Server

GoodBarber Skills

30 AI-powered skills to manage your GoodBarber app with any MCP-compatible client — eCommerce, Community, and Membership.

These skills connect to the GoodBarber MCP server and give your AI assistant structured workflows to manage your products, orders, customers, promotions, subscriptions, analytics, and more — all from a conversational interface.

---

What are Skills?

Skills are instruction files (.md) that teach an AI assistant how to perform specific tasks using your GoodBarber app's API via MCP (Model Context Protocol). Instead of manually calling API tools one by one, a skill orchestrates the full workflow — from data retrieval to formatted report — in a single natural-language request.

For example, asking "Show me my best sellers this month" triggers the best-sellers skill, which automatically fetches your orders and catalog, computes rankings, and returns a formatted report.

---

Quick Start

1. Connect the GoodBarber MCP

You need to add the GoodBarber MCP server as a custom connector in your client. The MCP server uses Server-Sent Events (SSE).

MCP Server URLs:

Replace <app_id> with your GoodBarber app ID if you manage multiple apps.

Claude Desktop (Cowork):

1. Open Settings > Connectors
2. Click Add custom connector
3. Enter the MCP server URL above
4. Authenticate with your GoodBarber credentials

Claude Code (CLI):

# Single app
claude mcp add goodbarber --transport sse https://mcp.goodbarber.dev/mcp/sse

# Multiple apps
claude mcp add goodbarber --transport sse https://mcp.goodbarber.dev/<app_id>/mcp/sse

Cursor / VS Code / Windsurf:

Add to your MCP configuration file (.cursor/mcp.json, .vscode/mcp.json, etc.):

{
  "mcpServers": {
    "goodbarber": {
      "url": "https://mcp.goodbarber.dev/mcp/sse"
    }
  }
}

Any other MCP-compatible client:

Point your client to the SSE endpoint above. The GoodBarber MCP server follows the standard MCP protocol and works with any compliant client.

2. Install the skills

Clone this repo and copy only the skills for your app type:

git clone https://github.com/goodbarber/goodbarber-skills.git

eCommerce app:

cp -r goodbarber-skills/skills/ecommerce/* ~/.claude/skills/

Community app:

cp -r goodbarber-skills/skills/community/* ~/.claude/skills/

Membership app:

cp -r goodbarber-skills/skills/membership/* ~/.claude/skills/

Tip: If your GoodBarber app combines multiple types (e.g. eCommerce + Membership), install skills from both directories.

3. Verify

Ask your AI assistant: "What skills do you have?" — it should list the installed GoodBarber skills.

---

Skills by App Type

eCommerce (17 skills)

---

Community (4 skills)

---

Membership (9 skills)

---

Usage Examples

"Show me my best sellers this month"
→ best-sellers

"Any products running low on stock?"
→ stock-check

"Create a 20% promo code for summer and notify everyone"
→ promo-campaign

"How's my churn rate looking?"
→ subscription-audit

"Send a push to the Paris group: meetup Friday at 7pm"
→ push-broadcast (community)

"Give me my weekly digest"
→ weekly-digest

---

Design Principles

All skills follow these rules:

• Pagination-aware — Large datasets are filtered server-side, not blindly paginated
• Fuzzy matching — Mention a product or collection by name; the skill resolves it
• Workflow chaining — Every skill suggests 2–3 related skills to run next
• No destructive actions without confirmation — Mutations always require explicit user validation
• Structured output — Every skill returns a formatted report, not a one-liner

---

Compatibility

These skills work with any MCP-compatible AI client, including:

• Claude Desktop (Cowork)
• Claude Code (CLI)
• Cursor
• VS Code (Copilot, Claude, Cline, etc.)
• Windsurf
• Codex CLI
• Gemini CLI
• Any client supporting the Model Context Protocol

---

Repo Structure

goodbarber-skills/
├── README.md
└── skills/
    ├── ecommerce/
    │   ├── best-sellers/SKILL.md
    │   ├── catalog-audit/SKILL.md
    │   ├── customer-insights/SKILL.md
    │   ├── ...
    │   └── weekly-digest/SKILL.md
    ├── community/
    │   ├── device-landscape/SKILL.md
    │   ├── push-broadcast/SKILL.md
    │   ├── traffic-report/SKILL.md
    │   └── weekly-digest/SKILL.md
    └── membership/
        ├── subscription-audit/SKILL.md
        ├── expiration-calendar/SKILL.md
        ├── ...
        └── weekly-digest/SKILL.md

---

Contributing

Want to add a skill? Create a folder in skills/<app-type>/ with a SKILL.md file. Follow the existing format: YAML frontmatter (name, description, compatibility) + markdown instructions with tool workflow, input/output contracts, and guardrails.

License

The Unlicense — public domain, no restrictions.