ElmapiCMS MCP Server

An MCP (Model Context Protocol) server that connects AI agents like Cursor and Claude Code to your ElmapiCMS instance. Manage collections, fields, content entries, assets, and webhooks programmatically through natural language.

Configuration

Usage with Cursor

Add this to your Cursor MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "elmapicms": {
      "command": "npx",
      "args": ["-y", "@elmapicms/mcp-server"],
      "env": {
        "ELMAPI_BASE_URL": "https://your-domain.com/api",
        "ELMAPI_API_KEY": "your-project-api-token",
        "ELMAPI_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

Usage with Claude Code

claude mcp add elmapicms \
  -e ELMAPI_BASE_URL=https://your-domain.com/api \
  -e ELMAPI_API_KEY=your-project-api-token \
  -e ELMAPI_PROJECT_ID=your-project-uuid \
  -- npx -y @elmapicms/mcp-server

Local Development (Laravel Herd / .test domains)

If your instance uses a self-signed certificate (e.g. Laravel Herd), you may need:

"env": {
  "ELMAPI_BASE_URL": "https://myproject.test/api",
  "ELMAPI_API_KEY": "your-project-api-token",
  "ELMAPI_PROJECT_ID": "your-project-uuid",
  "NODE_TLS_REJECT_UNAUTHORIZED": "0"
}

Prefer fixing local CA trust (e.g. node --use-system-ca) over disabling TLS verification in production configs.

Available Tools (40)

Project

• get_project — Get project information (default_locale, locales, etc.)
• add_project_locale — Add a locale code to the project (requires admin)
• set_default_project_locale — Set the default locale (requires admin)

Removing locales is intentionally not exposed here (use Project settings → Localization in the dashboard, or the REST/SDK APIs).

Collections

• list_collections — List all collections
• get_collection — Get a collection with its full field schema
• create_collection — Create a collection (with optional batch field creation)
• update_collection — Update a collection's name and slug
• reorder_collections — Reorder collections

Fields

• create_field — Add a field to a collection
• update_field — Update a field
• reorder_fields — Reorder fields within a collection

Content Entries

• list_entries — List entries with advanced filtering (where with 13 operators, OR groups, relation filtering), sorting, pagination, count, and first
• get_entry — Get a single content entry
• create_entry — Create a content entry
• update_entry — Update a content entry
• patch_entry — Partially update an entry (HTTP PATCH; merge only the fields you send)
• publish_entry — Publish the draft as a new immutable version (update)
• unpublish_entry — Clear the live published pointer; versions retained (update)
• discard_entry_draft — Discard unpublished draft changes (update)
• delete_entry — Soft-delete a content entry (moves to trash)
• bulk_create_entries — Create multiple entries atomically
• bulk_update_entries — Update multiple entries atomically by UUID
• bulk_delete_entries — Delete multiple entries atomically by UUID
• link_entry_translation — Link two entries (different locales) into the same translation group (POST …/link-translation; requires update)
• list_entry_versions — List version history for an entry
• get_entry_version — Fetch one version by number (includes snapshot payload)
• revert_entry_version — Restore draft from a prior snapshot and publish (update)
• update_entry_version_label — Edi

... View full README on GitHub