@contentful/mcp-server 1.14.0 → 1.16.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -9
- package/dist/index.js +7 -5
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -63,15 +63,15 @@ npm run build
|
|
|
63
63
|
|
|
64
64
|
### Environment Variables
|
|
65
65
|
|
|
66
|
-
| Environment Variable | Required | Default Value | Description
|
|
67
|
-
| ------------------------------------ | -------- | -------------------- |
|
|
68
|
-
| `CONTENTFUL_MANAGEMENT_ACCESS_TOKEN` | ✅ Yes | - | Your Contentful Management API personal access token
|
|
69
|
-
| `SPACE_ID` | ✅ Yes | - | Your Contentful Space ID
|
|
70
|
-
| `ENVIRONMENT_ID` | ❌ No | `master` | Target environment within your space
|
|
71
|
-
| `CONTENTFUL_HOST` | ❌ No | `api.contentful.com` | Contentful API host
|
|
72
|
-
| `NODE_ENV` | ❌ No | `production` | Node Environment to run in
|
|
73
|
-
| `MAX_BULK_SIZE` | ❌ No | `10` | Maximum number of IDs allowed in a single bulk-operation tool call (1–100). Caps publish/unpublish/archive/unarchive on entries and assets. Mitigates accidental mass operations from AI hallucinations.
|
|
74
|
-
| `ENABLE_EXO_TOOLS` | ❌ No | `false` | Opt in to Experience Orchestration (ExO) tools. Set to `true` to register the ExO tool collections (
|
|
66
|
+
| Environment Variable | Required | Default Value | Description |
|
|
67
|
+
| ------------------------------------ | -------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
68
|
+
| `CONTENTFUL_MANAGEMENT_ACCESS_TOKEN` | ✅ Yes | - | Your Contentful Management API personal access token |
|
|
69
|
+
| `SPACE_ID` | ✅ Yes | - | Your Contentful Space ID |
|
|
70
|
+
| `ENVIRONMENT_ID` | ❌ No | `master` | Target environment within your space |
|
|
71
|
+
| `CONTENTFUL_HOST` | ❌ No | `api.contentful.com` | Contentful API host |
|
|
72
|
+
| `NODE_ENV` | ❌ No | `production` | Node Environment to run in |
|
|
73
|
+
| `MAX_BULK_SIZE` | ❌ No | `10` | Maximum number of IDs allowed in a single bulk-operation tool call (1–100). Caps publish/unpublish/archive/unarchive on entries and assets. Mitigates accidental mass operations from AI hallucinations. |
|
|
74
|
+
| `ENABLE_EXO_TOOLS` | ❌ No | `false` | Opt in to Experience Orchestration (ExO) tools. Set to `true` to register the ExO tool collections (components, data assemblies, experiences, experience templates, experience fragments). Also requires the token to hold the `exoM1` entitlement in at least one accessible org — both gates must pass. |
|
|
75
75
|
|
|
76
76
|
### Configuration
|
|
77
77
|
|
|
@@ -164,6 +164,7 @@ Below is a sample configuration:
|
|
|
164
164
|
| | `space_to_space_param_collection` | Collect parameters for migration workflow |
|
|
165
165
|
| | `export_space` | Export space to file for migration |
|
|
166
166
|
| | `import_space` | Import space from exported file |
|
|
167
|
+
| **Usage** | `get_usages` | Get aggregated usage metrics for an organization, optionally filtered or grouped by space |
|
|
167
168
|
|
|
168
169
|
## 🤝 Contributing
|
|
169
170
|
|
package/dist/index.js
CHANGED
|
@@ -4106,7 +4106,7 @@ var EnvSchema = external_exports.object({
|
|
|
4106
4106
|
),
|
|
4107
4107
|
ORGANIZATION_ID: external_exports.string().optional().describe("Contentful organization ID"),
|
|
4108
4108
|
ENABLE_EXO_TOOLS: external_exports.string().optional().transform((v) => v === "true").describe(
|
|
4109
|
-
'Opt in to Experience Orchestration (ExO) tools. Set to "true" to register the ExO tool collections (
|
|
4109
|
+
'Opt in to Experience Orchestration (ExO) tools. Set to "true" to register the ExO tool collections (components, data assemblies, experiences, experience templates, experience fragments). Tools register only if the token also holds the exoM1 entitlement in at least one accessible org \u2014 both gates must pass. Defaults to off.'
|
|
4110
4110
|
),
|
|
4111
4111
|
CONTENTFUL_DELIVERY_TOKEN: external_exports.string().optional().describe(
|
|
4112
4112
|
"Contentful CDA token (used with export_space to export only published content)"
|
|
@@ -4126,7 +4126,7 @@ init_esm_shims();
|
|
|
4126
4126
|
|
|
4127
4127
|
// src/mcpVersion.ts
|
|
4128
4128
|
init_esm_shims();
|
|
4129
|
-
var MCP_VERSION = "1.
|
|
4129
|
+
var MCP_VERSION = "1.15.0";
|
|
4130
4130
|
|
|
4131
4131
|
// src/getVersion.ts
|
|
4132
4132
|
var getVersion = () => {
|
|
@@ -4171,6 +4171,7 @@ async function registerAllTools(server) {
|
|
|
4171
4171
|
const spaceTools = tools.getSpaceTools();
|
|
4172
4172
|
const tagTools = tools.getTagTools();
|
|
4173
4173
|
const taxonomyTools = tools.getTaxonomyTools();
|
|
4174
|
+
const usageTools = tools.getUsageTools();
|
|
4174
4175
|
const allToolCollections = [
|
|
4175
4176
|
aiActionTools,
|
|
4176
4177
|
assetTools,
|
|
@@ -4184,12 +4185,13 @@ async function registerAllTools(server) {
|
|
|
4184
4185
|
spaceTools,
|
|
4185
4186
|
tagTools,
|
|
4186
4187
|
taxonomyTools,
|
|
4188
|
+
usageTools,
|
|
4187
4189
|
...registerExoTools ? [
|
|
4188
|
-
tools.
|
|
4190
|
+
tools.getComponentTools(),
|
|
4189
4191
|
tools.getDataAssemblyTools(),
|
|
4190
4192
|
tools.getExperienceTools(),
|
|
4191
|
-
tools.
|
|
4192
|
-
tools.
|
|
4193
|
+
tools.getExperienceTemplateTools(),
|
|
4194
|
+
tools.getExperienceFragmentTools()
|
|
4193
4195
|
] : []
|
|
4194
4196
|
];
|
|
4195
4197
|
allToolCollections.forEach((toolCollection) => {
|