Skip to content
Back to search

copyelement-mcp

Official Model Context Protocol (MCP) server for CopyElement V4 components, wireframes, and Elementor design systems.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/me-saurabh--copyelement-mcp/badge.svg)](/listings/me-saurabh--copyelement-mcp)

HTML

<a href="/listings/me-saurabh--copyelement-mcp"><img src="/api/listings/me-saurabh--copyelement-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Run directly with `npx`:

npx copyelement-mcp

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 175 lines
  1. # copyelement-mcp
  2. > **The Official Model Context Protocol (MCP) Server for CopyElement V4.**
  3. > Give AI agents in **Claude Desktop, Cursor, Antigravity, Windsurf, and ChatGPT** direct superpowers to discover, inspect, and assemble 560+ production-grade Elementor V4 components, bento grids, and templates.
  4. [![npm version](https://img.shields.io/npm/v/copyelement-mcp.svg)](https://www.npmjs.com/package/copyelement-mcp)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  6. [![Elementor V4 Ready](https://img.shields.io/badge/Elementor-V4%20Atomic%20Containers-8b5cf6.svg)](https://copyelement.com)
  7. ---
  8. ## ⚡ What is CopyElement MCP?
  9. Elementor V4 introduced atomic flexbox/grid containers, CSS variables, and global classes. **CopyElement** is the largest curated library of production-ready Elementor V4 components.
  10. With **`copyelement-mcp`**, your AI coding assistants (Claude, Cursor, etc.) can:
  11. 1. **Search & Browse:** Query 560+ V4 components across 15+ categories (Hero, Bento Grids, Wireframes, Pricing, Testimonials, Footers).
  12. 2. **Inspect & Preview:** View live preview image URLs, responsive structure, and design tokens before inserting.
  13. 3. **Get Production Code:** Fetch the native Elementor V4 JSON element trees with zero manual copying.
  14. 4. **Assemble Complete Templates:** Automatically stitch multiple sections (e.g. Hero + Bento + Pricing + Footer) into a single 1-click importable `.json` page template file!
  15. ---
  16. ## 🚀 Quick Start (Zero Install via `npx`)
  17. Run directly with `npx`:
  18. ```bash
  19. npx copyelement-mcp
  20. ```
  21. ---
  22. ## 🛠️ Configuration for AI Clients
  23. ### 1. Claude Desktop
  24. Add this to your `claude_desktop_config.json`:
  25. * **MacOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
  26. * **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
  27. ```json
  28. {
  29. "mcpServers": {
  30. "copyelement": {
  31. "command": "npx",
  32. "args": ["-y", "copyelement-mcp"],
  33. "env": {
  34. "COPYELEMENT_API_KEY": "YOUR_COPYELEMENT_TOKEN_HERE"
  35. }
  36. }
  37. }
  38. }
  39. ```
  40. > **Authentication:** `COPYELEMENT_API_KEY` is required to retrieve and insert component JSON schemas. You can generate or find your token in your [CopyElement Account](https://copyelement.com).
  41. ---
  42. ### 2. Cursor IDE
  43. In your project root, create or edit `.cursor/mcp.json`:
  44. ```json
  45. {
  46. "mcpServers": {
  47. "copyelement": {
  48. "command": "npx",
  49. "args": ["-y", "copyelement-mcp"],
  50. "env": {
  51. "COPYELEMENT_API_KEY": "YOUR_COPYELEMENT_TOKEN_HERE"
  52. }
  53. }
  54. }
  55. }
  56. ```
  57. ---
  58. ### 3. Antigravity
  59. In Antigravity settings or `antigravity.json`:
  60. ```json
  61. {
  62. "mcpServers": {
  63. "copyelement": {
  64. "command": "npx",
  65. "args": ["-y", "copyelement-mcp"],
  66. "env": {
  67. "COPYELEMENT_API_KEY": "YOUR_COPYELEMENT_TOKEN_HERE"
  68. }
  69. }
  70. }
  71. }
  72. ```
  73. ---
  74. ## 🧰 Available MCP Tools
  75. ### `search_v4_components`
  76. Search components across categories, tags, or keywords.
  77. * **Arguments:**
  78. * `query` (optional): e.g. `"bento"`, `"split hero"`, `"dark pricing"`, `"testimonial"`
  79. * `category` (optional): e.g. `"hero"`, `"bento"`, `"wireframes"`, `"testimonials"`, `"pricing-table"`, `"footer"`
  80. * `filter` (optional): `"all"` | `"free"` | `"pro"` (default: `"all"`)
  81. * `limit` (optional): max items to return (default: `15`, max: `100`)
  82. ### `get_v4_categories`
  83. Returns all available layout categories and descriptions.
  84. ### `get_v4_component`
  85. Fetches detailed metadata, tags, and live preview image URL for a specific component UUID or slug.
  86. * **Arguments:**
  87. * `id` (required): Component UUID or slug
  88. ### `get_v4_elementor_payload`
  89. Streams the production-ready Elementor V4 JSON element container tree (`elements`) for insertion.
  90. * **Arguments:**
  91. * `id` (required): Component UUID
  92. * `type` (optional): `"component"` (default) or `"template"`
  93. * `apiKey` (optional): Override Bearer token if not set in environment
  94. ### `build_v4_page_template`
  95. Stitches multiple V4 components into a single valid Elementor page template `.json` file with deduplicated IDs.
  96. * **Arguments:**
  97. * `title` (required): Title for the template (e.g. `"SaaS Landing Page"`)
  98. * `component_ids` (required): Ordered list of UUIDs, e.g. `["hero-id", "bento-id", "pricing-id", "footer-id"]`
  99. ---
  100. ## 💡 Example AI Prompts
  101. Try asking Claude or Cursor:
  102. > *"Search for dark bento grids in CopyElement V4 and show me the preview links."*
  103. > *"Build a complete landing page using CopyElement V4 for a modern AI software company: pick a hero, a bento feature section, testimonials, pricing table, and a footer, and assemble them into a template JSON file."*
  104. > *"Find a free V4 wireframe hero and get its Elementor JSON code."*
  105. ---
  106. ## 🔒 Security & Cloud Privacy
  107. * **Zero R2 URL Exposure:** Storage URLs are kept 100% private. Payload retrieval is proxied server-to-server.
  108. * **Encrypted API Communication:** All communication routes through secure TLS endpoints with Bearer token authentication.
  109. ---
  110. ## 📦 Development & Local Testing
  111. Clone and test locally:
  112. ```bash
  113. git clone https://github.com/me-saurabh/copyelement-mcp.git
  114. cd copyelement-mcp
  115. npm install
  116. npm run build
  117. npm start
  118. ```
  119. ### Test with MCP Inspector:
  120. ```bash
  121. npx @modelcontextprotocol/inspector node dist/index.js
  122. ```
  123. ---
  124. ## 📄 License
  125. MIT License © [CopyElement](https://copyelement.com) & [Saurabh](https://github.com/me-saurabh).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.