@contentful/mcp-tools 0.4.5 → 0.8.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.
Files changed (3) hide show
  1. package/dist/index.d.ts +139 -16
  2. package/dist/index.js +1222 -529
  3. package/package.json +1 -1
package/dist/index.d.ts CHANGED
@@ -61,6 +61,10 @@ interface ContentfulConfig {
61
61
  deliveryToken?: string;
62
62
  /** Contentful Delivery API host (used with deliveryToken for custom CDA endpoints) */
63
63
  hostDelivery?: string;
64
+ /** Environment IDs that are protected from write/delete operations */
65
+ protectedEnvironments?: string[];
66
+ /** Maximum number of IDs allowed in a single bulk-operation tool call. Defaults to 10 when unset. */
67
+ maxBulkSize?: number;
64
68
  }
65
69
 
66
70
  /**
@@ -396,6 +400,8 @@ declare class ContentfulMcpTools {
396
400
  environmentId: zod.ZodString;
397
401
  } & {
398
402
  aiActionId: zod.ZodString;
403
+ confirm: zod.ZodOptional<zod.ZodBoolean>;
404
+ confirmToken: zod.ZodOptional<zod.ZodString>;
399
405
  };
400
406
  annotations: {
401
407
  readOnlyHint: boolean;
@@ -407,6 +413,8 @@ declare class ContentfulMcpTools {
407
413
  spaceId: string;
408
414
  environmentId: string;
409
415
  aiActionId: string;
416
+ confirmToken?: string | undefined;
417
+ confirm?: boolean | undefined;
410
418
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
411
419
  };
412
420
  getAiAction: {
@@ -649,12 +657,12 @@ declare class ContentfulMcpTools {
649
657
  contentType: zod.ZodString;
650
658
  upload: zod.ZodOptional<zod.ZodString>;
651
659
  }, "strip", zod.ZodTypeAny, {
652
- fileName: string;
653
660
  contentType: string;
661
+ fileName: string;
654
662
  upload?: string | undefined;
655
663
  }, {
656
- fileName: string;
657
664
  contentType: string;
665
+ fileName: string;
658
666
  upload?: string | undefined;
659
667
  }>;
660
668
  metadata: zod.ZodOptional<zod.ZodObject<{
@@ -756,8 +764,8 @@ declare class ContentfulMcpTools {
756
764
  spaceId: string;
757
765
  environmentId: string;
758
766
  file: {
759
- fileName: string;
760
767
  contentType: string;
768
+ fileName: string;
761
769
  upload?: string | undefined;
762
770
  };
763
771
  metadata?: {
@@ -802,12 +810,12 @@ declare class ContentfulMcpTools {
802
810
  tool: (params: {
803
811
  spaceId: string;
804
812
  environmentId: string;
813
+ locale?: string | undefined;
805
814
  skip?: number | undefined;
806
815
  limit?: number | undefined;
807
816
  select?: string | undefined;
808
817
  include?: number | undefined;
809
818
  order?: string | undefined;
810
- locale?: string | undefined;
811
819
  links_to_entry?: string | undefined;
812
820
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
813
821
  };
@@ -963,6 +971,8 @@ declare class ContentfulMcpTools {
963
971
  environmentId: zod.ZodString;
964
972
  } & {
965
973
  assetId: zod.ZodString;
974
+ confirm: zod.ZodOptional<zod.ZodBoolean>;
975
+ confirmToken: zod.ZodOptional<zod.ZodString>;
966
976
  };
967
977
  annotations: {
968
978
  readOnlyHint: boolean;
@@ -974,6 +984,8 @@ declare class ContentfulMcpTools {
974
984
  spaceId: string;
975
985
  environmentId: string;
976
986
  assetId: string;
987
+ confirmToken?: string | undefined;
988
+ confirm?: boolean | undefined;
977
989
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
978
990
  };
979
991
  publishAsset: {
@@ -984,6 +996,7 @@ declare class ContentfulMcpTools {
984
996
  environmentId: zod.ZodString;
985
997
  } & {
986
998
  assetId: zod.ZodUnion<[zod.ZodString, zod.ZodArray<zod.ZodString, "many">]>;
999
+ dryRun: zod.ZodOptional<zod.ZodBoolean>;
987
1000
  };
988
1001
  annotations: {
989
1002
  readOnlyHint: boolean;
@@ -995,6 +1008,7 @@ declare class ContentfulMcpTools {
995
1008
  spaceId: string;
996
1009
  environmentId: string;
997
1010
  assetId: string | string[];
1011
+ dryRun?: boolean | undefined;
998
1012
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
999
1013
  };
1000
1014
  unpublishAsset: {
@@ -1005,6 +1019,7 @@ declare class ContentfulMcpTools {
1005
1019
  environmentId: zod.ZodString;
1006
1020
  } & {
1007
1021
  assetId: zod.ZodUnion<[zod.ZodString, zod.ZodArray<zod.ZodString, "many">]>;
1022
+ dryRun: zod.ZodOptional<zod.ZodBoolean>;
1008
1023
  };
1009
1024
  annotations: {
1010
1025
  readOnlyHint: boolean;
@@ -1016,6 +1031,7 @@ declare class ContentfulMcpTools {
1016
1031
  spaceId: string;
1017
1032
  environmentId: string;
1018
1033
  assetId: string | string[];
1034
+ dryRun?: boolean | undefined;
1019
1035
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
1020
1036
  };
1021
1037
  archiveAsset: {
@@ -1026,6 +1042,7 @@ declare class ContentfulMcpTools {
1026
1042
  environmentId: zod.ZodString;
1027
1043
  } & {
1028
1044
  assetId: zod.ZodUnion<[zod.ZodString, zod.ZodArray<zod.ZodString, "many">]>;
1045
+ dryRun: zod.ZodOptional<zod.ZodBoolean>;
1029
1046
  };
1030
1047
  annotations: {
1031
1048
  readOnlyHint: boolean;
@@ -1037,6 +1054,7 @@ declare class ContentfulMcpTools {
1037
1054
  spaceId: string;
1038
1055
  environmentId: string;
1039
1056
  assetId: string | string[];
1057
+ dryRun?: boolean | undefined;
1040
1058
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
1041
1059
  };
1042
1060
  unarchiveAsset: {
@@ -1047,6 +1065,7 @@ declare class ContentfulMcpTools {
1047
1065
  environmentId: zod.ZodString;
1048
1066
  } & {
1049
1067
  assetId: zod.ZodUnion<[zod.ZodString, zod.ZodArray<zod.ZodString, "many">]>;
1068
+ dryRun: zod.ZodOptional<zod.ZodBoolean>;
1050
1069
  };
1051
1070
  annotations: {
1052
1071
  readOnlyHint: boolean;
@@ -1058,6 +1077,7 @@ declare class ContentfulMcpTools {
1058
1077
  spaceId: string;
1059
1078
  environmentId: string;
1060
1079
  assetId: string | string[];
1080
+ dryRun?: boolean | undefined;
1061
1081
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
1062
1082
  };
1063
1083
  };
@@ -3953,6 +3973,8 @@ declare class ContentfulMcpTools {
3953
3973
  environmentId: zod.ZodString;
3954
3974
  } & {
3955
3975
  contentTypeId: zod.ZodString;
3976
+ confirm: zod.ZodOptional<zod.ZodBoolean>;
3977
+ confirmToken: zod.ZodOptional<zod.ZodString>;
3956
3978
  };
3957
3979
  annotations: {
3958
3980
  readOnlyHint: boolean;
@@ -3964,6 +3986,8 @@ declare class ContentfulMcpTools {
3964
3986
  spaceId: string;
3965
3987
  environmentId: string;
3966
3988
  contentTypeId: string;
3989
+ confirmToken?: string | undefined;
3990
+ confirm?: boolean | undefined;
3967
3991
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
3968
3992
  };
3969
3993
  publishContentType: {
@@ -4008,6 +4032,81 @@ declare class ContentfulMcpTools {
4008
4032
  contentTypeId: string;
4009
4033
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
4010
4034
  };
4035
+ omitContentTypeField: {
4036
+ title: string;
4037
+ description: string;
4038
+ inputParams: {
4039
+ spaceId: zod.ZodString;
4040
+ environmentId: zod.ZodString;
4041
+ } & {
4042
+ contentTypeId: zod.ZodString;
4043
+ fieldId: zod.ZodString;
4044
+ omitted: zod.ZodDefault<zod.ZodBoolean>;
4045
+ };
4046
+ annotations: {
4047
+ readOnlyHint: boolean;
4048
+ destructiveHint: boolean;
4049
+ idempotentHint: boolean;
4050
+ openWorldHint: boolean;
4051
+ };
4052
+ tool: (params: {
4053
+ spaceId: string;
4054
+ environmentId: string;
4055
+ contentTypeId: string;
4056
+ omitted: boolean;
4057
+ fieldId: string;
4058
+ }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
4059
+ };
4060
+ deleteContentTypeField: {
4061
+ title: string;
4062
+ description: string;
4063
+ inputParams: {
4064
+ spaceId: zod.ZodString;
4065
+ environmentId: zod.ZodString;
4066
+ } & {
4067
+ contentTypeId: zod.ZodString;
4068
+ fieldId: zod.ZodString;
4069
+ };
4070
+ annotations: {
4071
+ readOnlyHint: boolean;
4072
+ destructiveHint: boolean;
4073
+ idempotentHint: boolean;
4074
+ openWorldHint: boolean;
4075
+ };
4076
+ tool: (params: {
4077
+ spaceId: string;
4078
+ environmentId: string;
4079
+ contentTypeId: string;
4080
+ fieldId: string;
4081
+ }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
4082
+ };
4083
+ disableContentTypeField: {
4084
+ title: string;
4085
+ description: string;
4086
+ inputParams: {
4087
+ spaceId: zod.ZodString;
4088
+ environmentId: zod.ZodString;
4089
+ } & {
4090
+ contentTypeId: zod.ZodString;
4091
+ fieldId: zod.ZodString;
4092
+ disabled: zod.ZodOptional<zod.ZodBoolean>;
4093
+ omitted: zod.ZodOptional<zod.ZodBoolean>;
4094
+ };
4095
+ annotations: {
4096
+ readOnlyHint: boolean;
4097
+ destructiveHint: boolean;
4098
+ idempotentHint: boolean;
4099
+ openWorldHint: boolean;
4100
+ };
4101
+ tool: (params: {
4102
+ spaceId: string;
4103
+ environmentId: string;
4104
+ contentTypeId: string;
4105
+ fieldId: string;
4106
+ disabled?: boolean | undefined;
4107
+ omitted?: boolean | undefined;
4108
+ }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
4109
+ };
4011
4110
  };
4012
4111
  /**
4013
4112
  * Get context tools
@@ -4889,6 +4988,8 @@ declare class ContentfulMcpTools {
4889
4988
  environmentId: zod.ZodString;
4890
4989
  } & {
4891
4990
  entryId: zod.ZodString;
4991
+ confirm: zod.ZodOptional<zod.ZodBoolean>;
4992
+ confirmToken: zod.ZodOptional<zod.ZodString>;
4892
4993
  };
4893
4994
  annotations: {
4894
4995
  readOnlyHint: boolean;
@@ -4900,6 +5001,8 @@ declare class ContentfulMcpTools {
4900
5001
  spaceId: string;
4901
5002
  environmentId: string;
4902
5003
  entryId: string;
5004
+ confirmToken?: string | undefined;
5005
+ confirm?: boolean | undefined;
4903
5006
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
4904
5007
  };
4905
5008
  publishEntry: {
@@ -4909,7 +5012,8 @@ declare class ContentfulMcpTools {
4909
5012
  spaceId: zod.ZodString;
4910
5013
  environmentId: zod.ZodString;
4911
5014
  } & {
4912
- entryId: zod.ZodUnion<[zod.ZodString, zod.ZodArray<zod.ZodString, "many">]>;
5015
+ entryId: zod.ZodArray<zod.ZodString, "many">;
5016
+ dryRun: zod.ZodOptional<zod.ZodBoolean>;
4913
5017
  };
4914
5018
  annotations: {
4915
5019
  readOnlyHint: boolean;
@@ -4920,7 +5024,8 @@ declare class ContentfulMcpTools {
4920
5024
  tool: (params: {
4921
5025
  spaceId: string;
4922
5026
  environmentId: string;
4923
- entryId: string | string[];
5027
+ entryId: string[];
5028
+ dryRun?: boolean | undefined;
4924
5029
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
4925
5030
  };
4926
5031
  unpublishEntry: {
@@ -4930,7 +5035,8 @@ declare class ContentfulMcpTools {
4930
5035
  spaceId: zod.ZodString;
4931
5036
  environmentId: zod.ZodString;
4932
5037
  } & {
4933
- entryId: zod.ZodUnion<[zod.ZodString, zod.ZodArray<zod.ZodString, "many">]>;
5038
+ entryId: zod.ZodArray<zod.ZodString, "many">;
5039
+ dryRun: zod.ZodOptional<zod.ZodBoolean>;
4934
5040
  };
4935
5041
  annotations: {
4936
5042
  readOnlyHint: boolean;
@@ -4941,7 +5047,8 @@ declare class ContentfulMcpTools {
4941
5047
  tool: (params: {
4942
5048
  spaceId: string;
4943
5049
  environmentId: string;
4944
- entryId: string | string[];
5050
+ entryId: string[];
5051
+ dryRun?: boolean | undefined;
4945
5052
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
4946
5053
  };
4947
5054
  archiveEntry: {
@@ -4951,7 +5058,8 @@ declare class ContentfulMcpTools {
4951
5058
  spaceId: zod.ZodString;
4952
5059
  environmentId: zod.ZodString;
4953
5060
  } & {
4954
- entryId: zod.ZodUnion<[zod.ZodString, zod.ZodArray<zod.ZodString, "many">]>;
5061
+ entryId: zod.ZodArray<zod.ZodString, "many">;
5062
+ dryRun: zod.ZodOptional<zod.ZodBoolean>;
4955
5063
  };
4956
5064
  annotations: {
4957
5065
  readOnlyHint: boolean;
@@ -4962,7 +5070,8 @@ declare class ContentfulMcpTools {
4962
5070
  tool: (params: {
4963
5071
  spaceId: string;
4964
5072
  environmentId: string;
4965
- entryId: string | string[];
5073
+ entryId: string[];
5074
+ dryRun?: boolean | undefined;
4966
5075
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
4967
5076
  };
4968
5077
  unarchiveEntry: {
@@ -4972,7 +5081,8 @@ declare class ContentfulMcpTools {
4972
5081
  spaceId: zod.ZodString;
4973
5082
  environmentId: zod.ZodString;
4974
5083
  } & {
4975
- entryId: zod.ZodUnion<[zod.ZodString, zod.ZodArray<zod.ZodString, "many">]>;
5084
+ entryId: zod.ZodArray<zod.ZodString, "many">;
5085
+ dryRun: zod.ZodOptional<zod.ZodBoolean>;
4976
5086
  };
4977
5087
  annotations: {
4978
5088
  readOnlyHint: boolean;
@@ -4983,7 +5093,8 @@ declare class ContentfulMcpTools {
4983
5093
  tool: (params: {
4984
5094
  spaceId: string;
4985
5095
  environmentId: string;
4986
- entryId: string | string[];
5096
+ entryId: string[];
5097
+ dryRun?: boolean | undefined;
4987
5098
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
4988
5099
  };
4989
5100
  };
@@ -5046,6 +5157,8 @@ declare class ContentfulMcpTools {
5046
5157
  spaceId: zod.ZodString;
5047
5158
  } & {
5048
5159
  environmentId: zod.ZodString;
5160
+ confirm: zod.ZodOptional<zod.ZodBoolean>;
5161
+ confirmToken: zod.ZodOptional<zod.ZodString>;
5049
5162
  };
5050
5163
  annotations: {
5051
5164
  readOnlyHint: boolean;
@@ -5056,6 +5169,8 @@ declare class ContentfulMcpTools {
5056
5169
  tool: (params: {
5057
5170
  spaceId: string;
5058
5171
  environmentId: string;
5172
+ confirmToken?: string | undefined;
5173
+ confirm?: boolean | undefined;
5059
5174
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
5060
5175
  };
5061
5176
  };
@@ -5201,6 +5316,8 @@ declare class ContentfulMcpTools {
5201
5316
  environmentId: zod.ZodString;
5202
5317
  } & {
5203
5318
  localeId: zod.ZodString;
5319
+ confirm: zod.ZodOptional<zod.ZodBoolean>;
5320
+ confirmToken: zod.ZodOptional<zod.ZodString>;
5204
5321
  };
5205
5322
  annotations: {
5206
5323
  readOnlyHint: boolean;
@@ -5212,6 +5329,8 @@ declare class ContentfulMcpTools {
5212
5329
  spaceId: string;
5213
5330
  environmentId: string;
5214
5331
  localeId: string;
5332
+ confirmToken?: string | undefined;
5333
+ confirm?: boolean | undefined;
5215
5334
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
5216
5335
  };
5217
5336
  };
@@ -5622,7 +5741,8 @@ declare class ContentfulMcpTools {
5622
5741
  inputParams: {
5623
5742
  organizationId: zod.ZodString;
5624
5743
  conceptId: zod.ZodString;
5625
- version: zod.ZodNumber;
5744
+ confirm: zod.ZodOptional<zod.ZodBoolean>;
5745
+ confirmToken: zod.ZodOptional<zod.ZodString>;
5626
5746
  };
5627
5747
  annotations: {
5628
5748
  readOnlyHint: boolean;
@@ -5631,9 +5751,10 @@ declare class ContentfulMcpTools {
5631
5751
  openWorldHint: boolean;
5632
5752
  };
5633
5753
  tool: (params: {
5634
- version: number;
5635
5754
  organizationId: string;
5636
5755
  conceptId: string;
5756
+ confirmToken?: string | undefined;
5757
+ confirm?: boolean | undefined;
5637
5758
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
5638
5759
  };
5639
5760
  createConceptScheme: {
@@ -5850,7 +5971,8 @@ declare class ContentfulMcpTools {
5850
5971
  inputParams: {
5851
5972
  organizationId: zod.ZodString;
5852
5973
  conceptSchemeId: zod.ZodString;
5853
- version: zod.ZodNumber;
5974
+ confirm: zod.ZodOptional<zod.ZodBoolean>;
5975
+ confirmToken: zod.ZodOptional<zod.ZodString>;
5854
5976
  };
5855
5977
  annotations: {
5856
5978
  readOnlyHint: boolean;
@@ -5859,9 +5981,10 @@ declare class ContentfulMcpTools {
5859
5981
  openWorldHint: boolean;
5860
5982
  };
5861
5983
  tool: (params: {
5862
- version: number;
5863
5984
  organizationId: string;
5864
5985
  conceptSchemeId: string;
5986
+ confirmToken?: string | undefined;
5987
+ confirm?: boolean | undefined;
5865
5988
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
5866
5989
  };
5867
5990
  };