@contentful/mcp-tools 0.12.5 → 0.12.7

package/README.md

@@ -146,6 +146,7 @@ Each tool includes semantic annotations to help MCP clients understand tool beha
 |                           | `space_to_space_param_collection`  | Collect parameters for migration workflow        |
 |                           | `export_space`                     | Export space to file for migration               |
 |                           | `import_space`                     | Import space from exported file                  |
+| **Usage**                 | `get_usages`                       | Get aggregated usage metrics for an organization, optionally filtered or grouped by space |
 
 ## Configuration
 

package/dist/index.d.ts

@@ -64,6 +64,8 @@ interface ContentfulConfig {
     appId?: string;
     /** Version number to use for MCP tool calls */
     mcpVersion: string;
+    /** Which MCP server surface is issuing the call. Threaded into the client-identifying headers for Datadog attribution. Defaults to 'local' when unset. */
+    mcpSource?: 'local' | 'remote';
     /** Contentful CDA token for exporting only published content */
     deliveryToken?: string;
     /** Contentful Delivery API host (used with deliveryToken for custom CDA endpoints) */
@@ -8846,6 +8848,44 @@ declare class ContentfulMcpTools {
             }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
         };
     };
+    /**
+     * Get usage tools
+     */
+    getUsageTools(): {
+        getUsages: {
+            title: string;
+            description: string;
+            inputParams: {
+                organizationId: zod.ZodOptional<zod.ZodString>;
+                metricKey: zod.ZodEnum<["api_call_cma", "api_call_cpa", "api_call_cda", "api_call_graphql", "asset_bandwidth", "functions_invocations", "ai_action_invocation", "ai_action_word_count", "ai_consumption_unit"]>;
+                dateGte: zod.ZodString;
+                dateLte: zod.ZodString;
+                granularity: zod.ZodOptional<zod.ZodEnum<["P1D", "P1M"]>>;
+                group: zod.ZodOptional<zod.ZodString>;
+                filter: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodString, zod.ZodArray<zod.ZodString, "many">]>>>;
+                limit: zod.ZodOptional<zod.ZodNumber>;
+                skip: zod.ZodOptional<zod.ZodNumber>;
+                order: zod.ZodOptional<zod.ZodString>;
+            };
+            annotations: {
+                readOnlyHint: boolean;
+                destructiveHint: boolean;
+                openWorldHint: boolean;
+            };
+            tool: (params: {
+                metricKey: "api_call_cma" | "api_call_cpa" | "api_call_cda" | "api_call_graphql" | "asset_bandwidth" | "functions_invocations" | "ai_action_invocation" | "ai_action_word_count" | "ai_consumption_unit";
+                dateGte: string;
+                dateLte: string;
+                filter?: Record<string, string | string[]> | undefined;
+                organizationId?: string | undefined;
+                skip?: number | undefined;
+                limit?: number | undefined;
+                order?: string | undefined;
+                granularity?: "P1D" | "P1M" | undefined;
+                group?: string | undefined;
+            }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
+        };
+    };
     /**
      * Get ExO experience fragment tools
      */