NomaCMS MCP Server

MCP server for NomaCMS. Manage collections, fields, content, assets, and webhooks via AI agents.

Local serverstdio

What is the NomaCMS MCP Server?

MCP server for NomaCMS. Manage collections, fields, content, assets, and webhooks via AI agents.

The short version

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

Recorded tools

  • read — list/get collections, entries, assets, webhooks; webhook logs
  • create — create entries, upload assets, create webhooks
  • update — update entries, link_entry_translation, update asset metadata, update webhooks
  • delete — delete entries, delete assets, delete webhooks
  • admin — create/update/reorder collections and fields; add/set default project locales (MCP does not expose locale removal)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_projectGet project information (default_locale, locales, etc.)
add_project_localeAdd a locale code to the project (requires admin)
set_default_project_localeSet the default locale (requires admin)
list_collectionsList all collections
get_collectionGet a collection with its full field schema
create_collectionCreate a collection (with optional batch field creation)
update_collectionUpdate a collection's name and slug
reorder_collectionsReorder collections
create_fieldAdd a field to a collection
update_fieldUpdate a field
reorder_fieldsReorder fields within a collection
list_entriesList entries with advanced filtering (where with 13 operators, OR groups, relation filtering), sorting, pagination, count, and first
get_entryGet a single content entry
create_entryCreate a content entry
update_entryUpdate a content entry
patch_entryPartially update an entry (HTTP PATCH; merge only the fields you send)
publish_entryPublish the draft as a new immutable version (update)
unpublish_entryClear the live published pointer; versions retained (update)
delete_entrySoft-delete a content entry (moves to trash)
bulk_create_entriesCreate multiple entries atomically
bulk_update_entriesUpdate multiple entries atomically by UUID
bulk_delete_entriesDelete multiple entries atomically by UUID
link_entry_translationLink two entries (different locales) into the same translation group (POST …/link-translation; requires update ability)
list_entry_versionsList version history for an entry
get_entry_versionFetch one version by number (includes snapshot payload)
revert_entry_versionRestore draft from a prior snapshot and publish (update)
update_entry_version_labelEdit label/description on a version; snapshot unchanged (update)
list_assetsList assets with pagination
get_assetGet an asset by UUID or filename
upload_assetUpload a file as an asset
bulk_upload_assetsUpload multiple files atomically
bulk_update_asset_metadataUpdate metadata for multiple assets atomically
delete_assetDelete an asset
list_webhooksList all webhooks for the project
get_webhookGet a webhook by UUID
create_webhookCreate a webhook for content and auth events (name, url, events, sources; optional description, secret, payload, status, collection_ids)
update_webhookUpdate a webhook by UUID (same fields as create)
delete_webhookDelete a webhook by UUID
list_webhook_logsList delivery logs for a webhook (uuid; optional paginate, page)

How to install the NomaCMS MCP Server

{
  "mcpServers": {
    "nomacms": {
      "command": "npx",
      "args": [
        "-y",
        "@nomacms/mcp-server"
      ],
      "env": {
        "NOMA_API_KEY": "YOUR_NOMA_API_KEY",
        "NOMA_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
NOMA_API_KEYDeclared in the maintainer’s client configuration.Check documentation
NOMA_PROJECT_IDDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use NomaCMS to Ability.”
  • “Use NomaCMS to read.”
  • “Use NomaCMS to create.”

Frequently asked questions

MCP server for NomaCMS. Manage collections, fields, content, assets, and webhooks via AI agents. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.