degree-dynamicweb-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@degree-dynamicweb-mcpList all item types"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
degree-dynamicweb-mcp
MCP (Model Context Protocol) server for DynamicWeb 10 Admin API. Gives Claude Code full access to manage DynamicWeb item types, fields, pages, paragraphs, and API discovery - without touching the DW Admin UI.
Tools
Item Types
Tool | Description |
| List all item types |
| Get item type details and restrictions |
| Create item type with fields, groups, and restrictions in one call |
| Update settings (name, category, icon, availability, etc.) |
| Update restrictions (allowed parents, children, websites, etc.) |
| Delete an item type |
Fields
Tool | Description |
| List fields on an item type |
| Add or update a field |
| Delete a field |
| List all available editor types from the DW instance (not hardcoded) |
Pages
Tool | Description |
| List pages, optionally filtered by area or parent |
| Get a page with all item fields |
| Create a page under a parent |
| Set item field values on a page |
| Delete a page |
| List all areas (websites) |
Paragraphs
Tool | Description |
| List paragraphs on a page |
| Get a paragraph with all item fields |
| Create a paragraph on a page |
| Set item field values on a paragraph |
| Delete a paragraph |
Products
Tool | Description |
| List products, optionally filtered by group or search |
| Get a single product (full model incl. CustomFields/CategoryFields) |
| Update top-level fields, customFields, and categoryFields on a product |
| Delete one or more products |
| Apply a percentage discount to DefaultPrice across a group or product list |
dw_product_update accepts three input maps:
fields- top-level product fields (Name, DefaultPrice, Stock, etc.)customFields- global product custom field values, keyed by SystemNamecategoryFields- product category field values, keyed by SystemName
Product Schema
Manage the PIM data model: product categories (groups of attributes) and product fields (the attributes themselves).
Tool | Description |
| List the 15 product field types (TypeId + aliases) |
| List product categories |
| Create or update a product category |
| Delete categories (3-step DW workflow handled internally) |
| List fields belonging to a category |
| Create or update a field on a category (accepts type aliases) |
| Delete fields from a single category |
Files
Tool | Description |
| List files in a directory, optionally filtered by extension |
| List subdirectories |
Delivery API (read-only)
Tool | Description |
| Fetch areas from Delivery API |
| Fetch pages with content |
| Fetch paragraphs with content |
API Discovery
Tool | Description |
| Search the Swagger spec for endpoints by keyword |
| Get request/response schema for an endpoint |
| Raw call to any Admin API endpoint |
Setup
1. Get a DW API token
In DynamicWeb Admin, go to Settings > Developer > API Keys and create a new key with full access.
2. Configure your AI client
Add to .mcp.json in your project:
{
"mcpServers": {
"dynamicweb": {
"command": "npx",
"args": ["-y", "@degree-as/dynamicweb-mcp"],
"env": {
"DW_BASE_URL": "https://your-dw-instance",
"DW_API_TOKEN": "your-token"
}
}
}
}Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"dynamicweb": {
"command": "npx",
"args": ["-y", "@degree-as/dynamicweb-mcp"],
"env": {
"DW_BASE_URL": "https://your-dw-instance",
"DW_API_TOKEN": "your-token"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
{
"mcpServers": {
"dynamicweb": {
"command": "npx",
"args": ["-y", "@degree-as/dynamicweb-mcp"],
"env": {
"DW_BASE_URL": "https://your-dw-instance",
"DW_API_TOKEN": "your-token"
}
}
}
}Add .vscode/mcp.json to your project (note: uses servers, not mcpServers):
{
"servers": {
"dynamicweb": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@degree-as/dynamicweb-mcp"],
"env": {
"DW_BASE_URL": "https://your-dw-instance",
"DW_API_TOKEN": "your-token"
}
}
}
}Edit ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"dynamicweb": {
"command": "npx",
"args": ["-y", "@degree-as/dynamicweb-mcp"],
"env": {
"DW_BASE_URL": "https://your-dw-instance",
"DW_API_TOKEN": "your-token"
}
}
}
}Configure via Cline's MCP settings UI, or add to its config:
{
"mcpServers": {
"dynamicweb": {
"command": "npx",
"args": ["-y", "@degree-as/dynamicweb-mcp"],
"env": {
"DW_BASE_URL": "https://your-dw-instance",
"DW_API_TOKEN": "your-token"
}
}
}
}Add to Zed's settings.json (note: uses context_servers):
{
"context_servers": {
"dynamicweb": {
"source": "custom",
"command": "npx",
"args": ["-y", "@degree-as/dynamicweb-mcp"],
"env": {
"DW_BASE_URL": "https://your-dw-instance",
"DW_API_TOKEN": "your-token"
}
}
}
}Add to ~/.continue/config.yaml:
mcpServers:
- name: dynamicweb
command: npx
args:
- -y
- "@degree-as/dynamicweb-mcp"
env:
DW_BASE_URL: https://your-dw-instance
DW_API_TOKEN: your-token3. Restart your client
The MCP server starts automatically when your AI client loads.
Local development
If you want to run from source instead of the published package:
git clone https://github.com/Degree-AS/degree-dynamicweb-mcp.git
cd degree-dynamicweb-mcp
npm install
npm run buildThen use "command": "node", "args": ["/path/to/degree-dynamicweb-mcp/dist/index.js"] in .mcp.json.
Field Type Aliases
Item type fields (dw_field_save, dw_itemtype_create)
When creating fields, you can use short aliases instead of full .NET class names:
Alias | Editor |
| TextEditor |
| LongTextEditor |
| RichTextEditor |
| RichTextEditorLight |
| FileEditor |
| FolderEditor |
| MediaEditor |
| LinkEditor |
| ItemLinkEditor |
| ItemRelationListEditor |
| IntegerEditor |
| DecimalEditor |
| DateEditor |
| DateTimeEditor |
| CheckboxEditor |
| CheckboxListEditor |
| DropDownListEditor |
| RadioButtonListEditor |
| EditableListEditor |
| ColorEditor |
| ColorSwatchEditor |
| ItemTypeEditor |
| ItemTypeTabEditor |
| UserEditor |
| SingleUserEditor |
| SingleUserGroupEditor |
| GeolocationEditor |
| GoogleFontEditor |
| HiddenFieldEditor |
| PasswordEditor |
Any full .NET editor class name is also accepted. Use dw_field_types to discover all available editors from your DW instance.
Product fields (dw_product_field_save)
Product fields use a different system - integer TypeId from FieldTypeAll, not editor class names:
Alias | TypeId | Name |
| 1 | Text (255) |
| 2 | Long text |
| 3 | Checkbox |
| 4 | Date |
| 5 | Date/Time |
| 6 | Integer |
| 7 | Decimal |
| 8 | Link |
| 9 | File |
| 10 | Text (100) |
| 11 | Text (50) |
| 12 | Text (20) |
| 13 | Text (5) |
| 14 | Editor |
| 15 | List |
Numeric TypeId is also accepted directly. Use dw_product_field_type_list to fetch the live list from your DW instance.
Architecture
src/
index.ts Entry point - reads config from env, registers tools
client.ts DwClient - HTTP client for Admin API, Update API, Delivery API
utils.ts Shared Zod helpers (jsonParam, numParam) and string helpers (pascal)
tools/
itemTypes.ts Item type CRUD, fields, restrictions, settings, editor discovery
pages.ts Page and area management
paragraphs.ts Paragraph management (uses ParagraphNew + ParagraphSave)
products.ts Product CRUD, bulk discount, custom/category field value updates
productSchema.ts Product categories and product field schema management
files.ts File and directory browsing
delivery.ts Read-only Delivery API
discovery.ts Swagger search, endpoint schema, raw API callsDW API surfaces
The DynamicWeb Admin API has three calling conventions:
Admin API (
GET /admin/api/{Endpoint}) - queries with URL paramsCommand API (
POST /admin/api/{Endpoint}) - mutations with{ Model: {...} }body. Delete commands use flat body (no Model wrapper).Update API (
POST /Admin/Api/{Endpoint}?Query.Type={Type}) - updates existing records with{ QueryData: {...}, model: {...} }body
DwClient has dedicated methods for each: get(), post(), command(), update(), delivery().
Development
npm run dev # Run with tsx (hot reload)
npm run build # Compile TypeScript
npm run start # Run compiled versionAfter changes, run npm run build and restart Claude Code to pick up the new version.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Degree-AS/degree-dynamicweb-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server