@contentful/mcp-tools 0.12.6 → 0.12.8

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 +86 -34
  2. package/dist/index.js +1473 -1089
  3. package/package.json +1 -1
package/dist/index.d.ts CHANGED
@@ -64,6 +64,8 @@ interface ContentfulConfig {
64
64
  appId?: string;
65
65
  /** Version number to use for MCP tool calls */
66
66
  mcpVersion: string;
67
+ /** Which MCP server surface is issuing the call. Threaded into the client-identifying headers for Datadog attribution. Defaults to 'local' when unset. */
68
+ mcpSource?: 'local' | 'remote';
67
69
  /** Contentful CDA token for exporting only published content */
68
70
  deliveryToken?: string;
69
71
  /** Contentful Delivery API host (used with deliveryToken for custom CDA endpoints) */
@@ -1095,6 +1097,56 @@ declare class ContentfulMcpTools {
1095
1097
  }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
1096
1098
  };
1097
1099
  };
1100
+ /**
1101
+ * Get content preview tools
1102
+ */
1103
+ getContentPreviewTools(): {
1104
+ listContentPreviews: {
1105
+ title: string;
1106
+ description: string;
1107
+ inputParams: {
1108
+ spaceId: zod.ZodString;
1109
+ contentTypeId: zod.ZodOptional<zod.ZodString>;
1110
+ limit: zod.ZodOptional<zod.ZodNumber>;
1111
+ skip: zod.ZodOptional<zod.ZodNumber>;
1112
+ };
1113
+ annotations: {
1114
+ readOnlyHint: boolean;
1115
+ destructiveHint: boolean;
1116
+ openWorldHint: boolean;
1117
+ };
1118
+ tool: (params: {
1119
+ spaceId: string;
1120
+ skip?: number | undefined;
1121
+ limit?: number | undefined;
1122
+ contentTypeId?: string | undefined;
1123
+ }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
1124
+ };
1125
+ getEntryPreviewUrl: {
1126
+ title: string;
1127
+ description: string;
1128
+ inputParams: {
1129
+ spaceId: zod.ZodString;
1130
+ environmentId: zod.ZodString;
1131
+ } & {
1132
+ entryId: zod.ZodString;
1133
+ previewId: zod.ZodOptional<zod.ZodString>;
1134
+ locale: zod.ZodOptional<zod.ZodString>;
1135
+ };
1136
+ annotations: {
1137
+ readOnlyHint: boolean;
1138
+ destructiveHint: boolean;
1139
+ openWorldHint: boolean;
1140
+ };
1141
+ tool: (params: {
1142
+ spaceId: string;
1143
+ environmentId: string;
1144
+ entryId: string;
1145
+ locale?: string | undefined;
1146
+ previewId?: string | undefined;
1147
+ }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
1148
+ };
1149
+ };
1098
1150
  /**
1099
1151
  * Get content type tools
1100
1152
  */
@@ -1378,8 +1430,8 @@ declare class ContentfulMcpTools {
1378
1430
  })[];
1379
1431
  }>]>>>;
1380
1432
  }, "strip", zod.ZodTypeAny, {
1381
- in?: (string | number)[] | undefined;
1382
1433
  message?: string | null | undefined;
1434
+ in?: (string | number)[] | undefined;
1383
1435
  size?: {
1384
1436
  min?: number | undefined;
1385
1437
  max?: number | undefined;
@@ -1443,8 +1495,8 @@ declare class ContentfulMcpTools {
1443
1495
  })[];
1444
1496
  }> | undefined;
1445
1497
  }, {
1446
- in?: (string | number)[] | undefined;
1447
1498
  message?: string | null | undefined;
1499
+ in?: (string | number)[] | undefined;
1448
1500
  size?: {
1449
1501
  min?: number | undefined;
1450
1502
  max?: number | undefined;
@@ -1726,8 +1778,8 @@ declare class ContentfulMcpTools {
1726
1778
  })[];
1727
1779
  }>]>>>;
1728
1780
  }, "strip", zod.ZodTypeAny, {
1729
- in?: (string | number)[] | undefined;
1730
1781
  message?: string | null | undefined;
1782
+ in?: (string | number)[] | undefined;
1731
1783
  size?: {
1732
1784
  min?: number | undefined;
1733
1785
  max?: number | undefined;
@@ -1791,8 +1843,8 @@ declare class ContentfulMcpTools {
1791
1843
  })[];
1792
1844
  }> | undefined;
1793
1845
  }, {
1794
- in?: (string | number)[] | undefined;
1795
1846
  message?: string | null | undefined;
1847
+ in?: (string | number)[] | undefined;
1796
1848
  size?: {
1797
1849
  min?: number | undefined;
1798
1850
  max?: number | undefined;
@@ -1860,8 +1912,8 @@ declare class ContentfulMcpTools {
1860
1912
  type: string;
1861
1913
  linkType?: string | undefined;
1862
1914
  validations?: {
1863
- in?: (string | number)[] | undefined;
1864
1915
  message?: string | null | undefined;
1916
+ in?: (string | number)[] | undefined;
1865
1917
  size?: {
1866
1918
  min?: number | undefined;
1867
1919
  max?: number | undefined;
@@ -1929,8 +1981,8 @@ declare class ContentfulMcpTools {
1929
1981
  type: string;
1930
1982
  linkType?: string | undefined;
1931
1983
  validations?: {
1932
- in?: (string | number)[] | undefined;
1933
1984
  message?: string | null | undefined;
1985
+ in?: (string | number)[] | undefined;
1934
1986
  size?: {
1935
1987
  min?: number | undefined;
1936
1988
  max?: number | undefined;
@@ -2005,8 +2057,8 @@ declare class ContentfulMcpTools {
2005
2057
  type: string;
2006
2058
  linkType?: string | undefined;
2007
2059
  validations?: {
2008
- in?: (string | number)[] | undefined;
2009
2060
  message?: string | null | undefined;
2061
+ in?: (string | number)[] | undefined;
2010
2062
  size?: {
2011
2063
  min?: number | undefined;
2012
2064
  max?: number | undefined;
@@ -2073,8 +2125,8 @@ declare class ContentfulMcpTools {
2073
2125
  } | undefined;
2074
2126
  linkType?: string | undefined;
2075
2127
  validations?: {
2076
- in?: (string | number)[] | undefined;
2077
2128
  message?: string | null | undefined;
2129
+ in?: (string | number)[] | undefined;
2078
2130
  size?: {
2079
2131
  min?: number | undefined;
2080
2132
  max?: number | undefined;
@@ -2152,8 +2204,8 @@ declare class ContentfulMcpTools {
2152
2204
  type: string;
2153
2205
  linkType?: string | undefined;
2154
2206
  validations?: {
2155
- in?: (string | number)[] | undefined;
2156
2207
  message?: string | null | undefined;
2208
+ in?: (string | number)[] | undefined;
2157
2209
  size?: {
2158
2210
  min?: number | undefined;
2159
2211
  max?: number | undefined;
@@ -2220,8 +2272,8 @@ declare class ContentfulMcpTools {
2220
2272
  } | undefined;
2221
2273
  linkType?: string | undefined;
2222
2274
  validations?: {
2223
- in?: (string | number)[] | undefined;
2224
2275
  message?: string | null | undefined;
2276
+ in?: (string | number)[] | undefined;
2225
2277
  size?: {
2226
2278
  min?: number | undefined;
2227
2279
  max?: number | undefined;
@@ -2404,8 +2456,8 @@ declare class ContentfulMcpTools {
2404
2456
  type: string;
2405
2457
  linkType?: string | undefined;
2406
2458
  validations?: {
2407
- in?: (string | number)[] | undefined;
2408
2459
  message?: string | null | undefined;
2460
+ in?: (string | number)[] | undefined;
2409
2461
  size?: {
2410
2462
  min?: number | undefined;
2411
2463
  max?: number | undefined;
@@ -2472,8 +2524,8 @@ declare class ContentfulMcpTools {
2472
2524
  } | undefined;
2473
2525
  linkType?: string | undefined;
2474
2526
  validations?: {
2475
- in?: (string | number)[] | undefined;
2476
2527
  message?: string | null | undefined;
2528
+ in?: (string | number)[] | undefined;
2477
2529
  size?: {
2478
2530
  min?: number | undefined;
2479
2531
  max?: number | undefined;
@@ -2795,8 +2847,8 @@ declare class ContentfulMcpTools {
2795
2847
  })[];
2796
2848
  }>]>>>;
2797
2849
  }, "strip", zod.ZodTypeAny, {
2798
- in?: (string | number)[] | undefined;
2799
2850
  message?: string | null | undefined;
2851
+ in?: (string | number)[] | undefined;
2800
2852
  size?: {
2801
2853
  min?: number | undefined;
2802
2854
  max?: number | undefined;
@@ -2860,8 +2912,8 @@ declare class ContentfulMcpTools {
2860
2912
  })[];
2861
2913
  }> | undefined;
2862
2914
  }, {
2863
- in?: (string | number)[] | undefined;
2864
2915
  message?: string | null | undefined;
2916
+ in?: (string | number)[] | undefined;
2865
2917
  size?: {
2866
2918
  min?: number | undefined;
2867
2919
  max?: number | undefined;
@@ -3143,8 +3195,8 @@ declare class ContentfulMcpTools {
3143
3195
  })[];
3144
3196
  }>]>>>;
3145
3197
  }, "strip", zod.ZodTypeAny, {
3146
- in?: (string | number)[] | undefined;
3147
3198
  message?: string | null | undefined;
3199
+ in?: (string | number)[] | undefined;
3148
3200
  size?: {
3149
3201
  min?: number | undefined;
3150
3202
  max?: number | undefined;
@@ -3208,8 +3260,8 @@ declare class ContentfulMcpTools {
3208
3260
  })[];
3209
3261
  }> | undefined;
3210
3262
  }, {
3211
- in?: (string | number)[] | undefined;
3212
3263
  message?: string | null | undefined;
3264
+ in?: (string | number)[] | undefined;
3213
3265
  size?: {
3214
3266
  min?: number | undefined;
3215
3267
  max?: number | undefined;
@@ -3277,8 +3329,8 @@ declare class ContentfulMcpTools {
3277
3329
  type: string;
3278
3330
  linkType?: string | undefined;
3279
3331
  validations?: {
3280
- in?: (string | number)[] | undefined;
3281
3332
  message?: string | null | undefined;
3333
+ in?: (string | number)[] | undefined;
3282
3334
  size?: {
3283
3335
  min?: number | undefined;
3284
3336
  max?: number | undefined;
@@ -3346,8 +3398,8 @@ declare class ContentfulMcpTools {
3346
3398
  type: string;
3347
3399
  linkType?: string | undefined;
3348
3400
  validations?: {
3349
- in?: (string | number)[] | undefined;
3350
3401
  message?: string | null | undefined;
3402
+ in?: (string | number)[] | undefined;
3351
3403
  size?: {
3352
3404
  min?: number | undefined;
3353
3405
  max?: number | undefined;
@@ -3422,8 +3474,8 @@ declare class ContentfulMcpTools {
3422
3474
  type: string;
3423
3475
  linkType?: string | undefined;
3424
3476
  validations?: {
3425
- in?: (string | number)[] | undefined;
3426
3477
  message?: string | null | undefined;
3478
+ in?: (string | number)[] | undefined;
3427
3479
  size?: {
3428
3480
  min?: number | undefined;
3429
3481
  max?: number | undefined;
@@ -3490,8 +3542,8 @@ declare class ContentfulMcpTools {
3490
3542
  } | undefined;
3491
3543
  linkType?: string | undefined;
3492
3544
  validations?: {
3493
- in?: (string | number)[] | undefined;
3494
3545
  message?: string | null | undefined;
3546
+ in?: (string | number)[] | undefined;
3495
3547
  size?: {
3496
3548
  min?: number | undefined;
3497
3549
  max?: number | undefined;
@@ -3569,8 +3621,8 @@ declare class ContentfulMcpTools {
3569
3621
  type: string;
3570
3622
  linkType?: string | undefined;
3571
3623
  validations?: {
3572
- in?: (string | number)[] | undefined;
3573
3624
  message?: string | null | undefined;
3625
+ in?: (string | number)[] | undefined;
3574
3626
  size?: {
3575
3627
  min?: number | undefined;
3576
3628
  max?: number | undefined;
@@ -3637,8 +3689,8 @@ declare class ContentfulMcpTools {
3637
3689
  } | undefined;
3638
3690
  linkType?: string | undefined;
3639
3691
  validations?: {
3640
- in?: (string | number)[] | undefined;
3641
3692
  message?: string | null | undefined;
3693
+ in?: (string | number)[] | undefined;
3642
3694
  size?: {
3643
3695
  min?: number | undefined;
3644
3696
  max?: number | undefined;
@@ -3811,6 +3863,7 @@ declare class ContentfulMcpTools {
3811
3863
  spaceId: string;
3812
3864
  environmentId: string;
3813
3865
  contentTypeId: string;
3866
+ name?: string | undefined;
3814
3867
  metadata?: {
3815
3868
  taxonomy?: ({
3816
3869
  sys: {
@@ -3828,7 +3881,6 @@ declare class ContentfulMcpTools {
3828
3881
  required?: boolean | undefined;
3829
3882
  })[] | undefined;
3830
3883
  } | undefined;
3831
- name?: string | undefined;
3832
3884
  description?: string | undefined;
3833
3885
  fields?: {
3834
3886
  name: string;
@@ -3840,8 +3892,8 @@ declare class ContentfulMcpTools {
3840
3892
  type: string;
3841
3893
  linkType?: string | undefined;
3842
3894
  validations?: {
3843
- in?: (string | number)[] | undefined;
3844
3895
  message?: string | null | undefined;
3896
+ in?: (string | number)[] | undefined;
3845
3897
  size?: {
3846
3898
  min?: number | undefined;
3847
3899
  max?: number | undefined;
@@ -3908,8 +3960,8 @@ declare class ContentfulMcpTools {
3908
3960
  } | undefined;
3909
3961
  linkType?: string | undefined;
3910
3962
  validations?: {
3911
- in?: (string | number)[] | undefined;
3912
3963
  message?: string | null | undefined;
3964
+ in?: (string | number)[] | undefined;
3913
3965
  size?: {
3914
3966
  min?: number | undefined;
3915
3967
  max?: number | undefined;
@@ -4987,6 +5039,7 @@ declare class ContentfulMcpTools {
4987
5039
  spaceId: string;
4988
5040
  environmentId: string;
4989
5041
  componentId: string;
5042
+ name?: string | undefined;
4990
5043
  metadata?: {
4991
5044
  tags?: {
4992
5045
  sys: {
@@ -5003,7 +5056,6 @@ declare class ContentfulMcpTools {
5003
5056
  };
5004
5057
  }[] | undefined;
5005
5058
  } | undefined;
5006
- name?: string | undefined;
5007
5059
  description?: string | undefined;
5008
5060
  designProperties?: ({
5009
5061
  name: string;
@@ -6009,6 +6061,7 @@ declare class ContentfulMcpTools {
6009
6061
  spaceId: string;
6010
6062
  environmentId: string;
6011
6063
  experienceTemplateId: string;
6064
+ name?: string | undefined;
6012
6065
  metadata?: {
6013
6066
  tags?: {
6014
6067
  sys: {
@@ -6025,7 +6078,6 @@ declare class ContentfulMcpTools {
6025
6078
  };
6026
6079
  }[] | undefined;
6027
6080
  } | undefined;
6028
- name?: string | undefined;
6029
6081
  description?: string | undefined;
6030
6082
  designProperties?: ({
6031
6083
  name: string;
@@ -6731,6 +6783,7 @@ declare class ContentfulMcpTools {
6731
6783
  spaceId: string;
6732
6784
  environmentId: string;
6733
6785
  experienceId: string;
6786
+ name?: string | undefined;
6734
6787
  metadata?: {
6735
6788
  name?: string | undefined;
6736
6789
  tags?: {
@@ -6748,7 +6801,6 @@ declare class ContentfulMcpTools {
6748
6801
  };
6749
6802
  }[] | undefined;
6750
6803
  } | undefined;
6751
- name?: string | undefined;
6752
6804
  description?: string | undefined;
6753
6805
  designProperties?: Record<string, Record<string, {
6754
6806
  value: string;
@@ -8067,9 +8119,9 @@ declare class ContentfulMcpTools {
8067
8119
  openWorldHint: boolean;
8068
8120
  };
8069
8121
  tool: (params: {
8122
+ name: string;
8070
8123
  default: boolean;
8071
8124
  optional: boolean;
8072
- name: string;
8073
8125
  spaceId: string;
8074
8126
  environmentId: string;
8075
8127
  code: string;
@@ -8122,15 +8174,15 @@ declare class ContentfulMcpTools {
8122
8174
  contentManagementApi: zod.ZodOptional<zod.ZodBoolean>;
8123
8175
  optional: zod.ZodOptional<zod.ZodBoolean>;
8124
8176
  }, "strip", zod.ZodTypeAny, {
8125
- optional?: boolean | undefined;
8126
8177
  name?: string | undefined;
8178
+ optional?: boolean | undefined;
8127
8179
  code?: string | undefined;
8128
8180
  fallbackCode?: string | undefined;
8129
8181
  contentDeliveryApi?: boolean | undefined;
8130
8182
  contentManagementApi?: boolean | undefined;
8131
8183
  }, {
8132
- optional?: boolean | undefined;
8133
8184
  name?: string | undefined;
8185
+ optional?: boolean | undefined;
8134
8186
  code?: string | undefined;
8135
8187
  fallbackCode?: string | undefined;
8136
8188
  contentDeliveryApi?: boolean | undefined;
@@ -8147,8 +8199,8 @@ declare class ContentfulMcpTools {
8147
8199
  spaceId: string;
8148
8200
  environmentId: string;
8149
8201
  fields: {
8150
- optional?: boolean | undefined;
8151
8202
  name?: string | undefined;
8203
+ optional?: boolean | undefined;
8152
8204
  code?: string | undefined;
8153
8205
  fallbackCode?: string | undefined;
8154
8206
  contentDeliveryApi?: boolean | undefined;
@@ -9447,6 +9499,7 @@ declare class ContentfulMcpTools {
9447
9499
  spaceId: string;
9448
9500
  environmentId: string;
9449
9501
  experienceFragmentId: string;
9502
+ name?: string | undefined;
9450
9503
  metadata?: {
9451
9504
  name?: string | undefined;
9452
9505
  tags?: {
@@ -9464,7 +9517,6 @@ declare class ContentfulMcpTools {
9464
9517
  };
9465
9518
  }[] | undefined;
9466
9519
  } | undefined;
9467
- name?: string | undefined;
9468
9520
  description?: string | undefined;
9469
9521
  designProperties?: Record<string, Record<string, {
9470
9522
  value: string;
@@ -10132,6 +10184,7 @@ declare class ContentfulMcpTools {
10132
10184
  spaceId: string;
10133
10185
  environmentId: string;
10134
10186
  dataAssemblyId: string;
10187
+ name?: string | undefined;
10135
10188
  metadata?: {
10136
10189
  tags: {
10137
10190
  sys: {
@@ -10141,7 +10194,6 @@ declare class ContentfulMcpTools {
10141
10194
  };
10142
10195
  }[];
10143
10196
  } | undefined;
10144
- name?: string | undefined;
10145
10197
  description?: string | undefined;
10146
10198
  parameters?: Record<string, {
10147
10199
  type: "ResourceLink";