@contentful/mcp-tools 0.12.12 → 0.12.14

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 CHANGED
@@ -65,6 +65,7 @@ import {
65
65
  jobTools, // Long-running jobs
66
66
  localeTools, // Locale management
67
67
  orgTools, // Organization operations
68
+ releaseTools, // Release management
68
69
  spaceTools, // Space operations
69
70
  tagTools, // Tag management
70
71
  taxonomyTools, // Taxonomy/concept scheme operations
@@ -82,70 +83,80 @@ Each tool includes semantic annotations to help MCP clients understand tool beha
82
83
 
83
84
  ## 🛠️ Available Tools
84
85
 
85
- | Category | Tool Name | Description |
86
- | ------------------------- | ---------------------------------- | ------------------------------------------------ |
87
- | **Context & Setup** | `get_initial_context` | Initialize connection and get usage instructions |
88
- | **Content Types** | `list_content_types` | List content types (max 10 per request) |
89
- | | `get_content_type` | Get detailed content type information |
90
- | | `create_content_type` | Create new content types |
91
- | | `update_content_type` | Modify existing content types |
92
- | | `publish_content_type` | Publish content type changes |
93
- | | `unpublish_content_type` | Unpublish content types |
94
- | | `delete_content_type` | Remove content types |
95
- | **Entries** | `search_entries` | Search and filter entries in your space |
96
- | | `get_entry` | Retrieve specific entries |
97
- | | `create_entry` | Create new content entries with locale support |
98
- | | `update_entry` | Modify existing entries with locale support |
99
- | | `publish_entry` | Publish entries (single or bulk up to 100) |
100
- | | `unpublish_entry` | Unpublish entries (single or bulk up to 100) |
101
- | | `delete_entry` | Remove entries |
102
- | **Editor Interfaces** | `list_editor_interfaces` | List all editor interfaces in a space |
103
- | | `get_editor_interface` | Get editor interface for a content type |
104
- | | `update_editor_interface` | Update field controls, sidebars, and layouts |
105
- | **Assets** | `upload_asset` | Upload new assets |
106
- | | `list_assets` | List and browse assets (max 3 per request) |
107
- | | `get_asset` | Retrieve specific assets |
108
- | | `update_asset` | Modify asset metadata |
109
- | | `publish_asset` | Publish assets (single or bulk up to 100) |
110
- | | `unpublish_asset` | Unpublish assets (single or bulk up to 100) |
111
- | | `delete_asset` | Remove assets |
112
- | **Spaces & Environments** | `list_spaces` | List available spaces (max 10 per request) |
113
- | | `get_space` | Get space details |
114
- | | `list_environments` | List environments in a space |
115
- | | `create_environment` | Create new environments |
116
- | | `delete_environment` | Remove environments |
117
- | **Locales** | `list_locales` | List all locales in your environment |
118
- | | `get_locale` | Retrieve specific locale information |
119
- | | `create_locale` | Create new locales for multi-language content |
120
- | | `update_locale` | Modify existing locale settings |
121
- | | `delete_locale` | Remove locales from environment |
122
- | **Tags** | `list_tags` | List all tags in an environment |
123
- | | `create_tag` | Create new tags with public/private visibility |
124
- | **Organizations** | `list_orgs` | List organizations user has access to |
125
- | | `get_org` | Get details of a specific organization |
126
- | **AI Actions** | `create_ai_action` | Create custom AI-powered workflows |
127
- | | `invoke_ai_action` | Invoke AI action with variables (bulk support) |
128
- | | `get_ai_action_invocation` | Get AI action invocation details |
129
- | | `get_ai_action` | Retrieve AI action details and configuration |
130
- | | `list_ai_actions` | List AI actions in a space (max 3 per request) |
131
- | | `update_ai_action` | Update existing AI actions |
132
- | | `publish_ai_action` | Publish AI actions for use |
133
- | | `unpublish_ai_action` | Unpublish AI actions |
134
- | | `delete_ai_action` | Remove AI actions |
135
- | **Taxonomy Concepts** | `create_concept` | Create new taxonomy concepts with localization |
136
- | | `get_concept` | Retrieve specific taxonomy concept |
137
- | | `list_concepts` | List concepts with filtering and hierarchy |
138
- | | `update_concept` | Update taxonomy concept properties |
139
- | | `delete_concept` | Remove taxonomy concepts |
140
- | **Taxonomy Schemes** | `create_concept_scheme` | Create new taxonomy concept schemes |
141
- | | `get_concept_scheme` | Retrieve specific concept scheme |
142
- | | `list_concept_schemes` | List concept schemes with pagination |
143
- | | `update_concept_scheme` | Update concept scheme properties |
144
- | | `delete_concept_scheme` | Remove concept schemes |
145
- | **Space Migration** | `space_to_space_migration_handler` | Enable/disable space migration workflow |
146
- | | `space_to_space_param_collection` | Collect parameters for migration workflow |
147
- | | `export_space` | Export space to file for migration |
148
- | | `import_space` | Import space from exported file |
86
+ | Category | Tool Name | Description |
87
+ | ------------------------- | ---------------------------------- | ----------------------------------------------------------------------------------------- |
88
+ | **Context & Setup** | `get_initial_context` | Initialize connection and get usage instructions |
89
+ | **Content Types** | `list_content_types` | List content types (max 10 per request) |
90
+ | | `get_content_type` | Get detailed content type information |
91
+ | | `create_content_type` | Create new content types |
92
+ | | `update_content_type` | Modify existing content types |
93
+ | | `publish_content_type` | Publish content type changes |
94
+ | | `unpublish_content_type` | Unpublish content types |
95
+ | | `delete_content_type` | Remove content types |
96
+ | **Entries** | `search_entries` | Search and filter entries in your space |
97
+ | | `get_entry` | Retrieve specific entries |
98
+ | | `create_entry` | Create new content entries with locale support |
99
+ | | `update_entry` | Modify existing entries with locale support |
100
+ | | `publish_entry` | Publish entries (single or bulk up to 100) |
101
+ | | `unpublish_entry` | Unpublish entries (single or bulk up to 100) |
102
+ | | `delete_entry` | Remove entries |
103
+ | **Editor Interfaces** | `list_editor_interfaces` | List all editor interfaces in a space |
104
+ | | `get_editor_interface` | Get editor interface for a content type |
105
+ | | `update_editor_interface` | Update field controls, sidebars, and layouts |
106
+ | **Assets** | `upload_asset` | Upload new assets |
107
+ | | `list_assets` | List and browse assets (max 3 per request) |
108
+ | | `get_asset` | Retrieve specific assets |
109
+ | | `update_asset` | Modify asset metadata |
110
+ | | `publish_asset` | Publish assets (single or bulk up to 100) |
111
+ | | `unpublish_asset` | Unpublish assets (single or bulk up to 100) |
112
+ | | `delete_asset` | Remove assets |
113
+ | **Spaces & Environments** | `list_spaces` | List available spaces (max 10 per request) |
114
+ | | `get_space` | Get space details |
115
+ | | `list_environments` | List environments in a space |
116
+ | | `create_environment` | Create new environments |
117
+ | | `delete_environment` | Remove environments |
118
+ | **Locales** | `list_locales` | List all locales in your environment |
119
+ | | `get_locale` | Retrieve specific locale information |
120
+ | | `create_locale` | Create new locales for multi-language content |
121
+ | | `update_locale` | Modify existing locale settings |
122
+ | | `delete_locale` | Remove locales from environment |
123
+ | **Tags** | `list_tags` | List all tags in an environment |
124
+ | | `create_tag` | Create new tags with public/private visibility |
125
+ | **Organizations** | `list_orgs` | List organizations user has access to |
126
+ | | `get_org` | Get details of a specific organization |
127
+ | **Releases** | `list_releases` | List releases (max 10 per request) |
128
+ | | `get_release` | Retrieve a release |
129
+ | | `create_release` | Create a release with Entries/Assets |
130
+ | | `update_release` | Modify a release's title and/or contents |
131
+ | | `delete_release` | Remove a release (and its linked release actions) |
132
+ | | `publish_release` | Publish a release (async; check via `get_release_action`) |
133
+ | | `unpublish_release` | Unpublish a release (async; check via `get_release_action`) |
134
+ | | `validate_release` | Validate a release, optionally against publish/unpublish |
135
+ | | `get_release_action` | Check the status of a queued release action |
136
+ | | `list_release_actions` | List release actions (max 10 per request) |
137
+ | **AI Actions** | `create_ai_action` | Create custom AI-powered workflows |
138
+ | | `invoke_ai_action` | Invoke AI action with variables (bulk support) |
139
+ | | `get_ai_action_invocation` | Get AI action invocation details |
140
+ | | `get_ai_action` | Retrieve AI action details and configuration |
141
+ | | `list_ai_actions` | List AI actions in a space (max 3 per request) |
142
+ | | `update_ai_action` | Update existing AI actions |
143
+ | | `publish_ai_action` | Publish AI actions for use |
144
+ | | `unpublish_ai_action` | Unpublish AI actions |
145
+ | | `delete_ai_action` | Remove AI actions |
146
+ | **Taxonomy Concepts** | `create_concept` | Create new taxonomy concepts with localization |
147
+ | | `get_concept` | Retrieve specific taxonomy concept |
148
+ | | `list_concepts` | List concepts with filtering and hierarchy |
149
+ | | `update_concept` | Update taxonomy concept properties |
150
+ | | `delete_concept` | Remove taxonomy concepts |
151
+ | **Taxonomy Schemes** | `create_concept_scheme` | Create new taxonomy concept schemes |
152
+ | | `get_concept_scheme` | Retrieve specific concept scheme |
153
+ | | `list_concept_schemes` | List concept schemes with pagination |
154
+ | | `update_concept_scheme` | Update concept scheme properties |
155
+ | | `delete_concept_scheme` | Remove concept schemes |
156
+ | **Space Migration** | `space_to_space_migration_handler` | Enable/disable space migration workflow |
157
+ | | `space_to_space_param_collection` | Collect parameters for migration workflow |
158
+ | | `export_space` | Export space to file for migration |
159
+ | | `import_space` | Import space from exported file |
149
160
  | **Usage** | `get_usages` | Get aggregated usage metrics for an organization, optionally filtered or grouped by space |
150
161
 
151
162
  ## Configuration