@smartbear/mcp 0.24.0 → 0.25.0

package/dist/pactflow/client/tools.js

@@ -4,6 +4,7 @@ import { CanIDeploySchema, MatrixSchema, GetPacticipantSchema, ListBranchesSchem
 const TOOLS = [
   {
     title: "Generate Pact Tests",
+    toolset: "Generate Pact Tests",
     summary: "Generate Pact tests using PactFlow AI. You can provide one or more of the following input types: (1) request/response pairs for specific interactions, (2) code files to analyze and extract interactions from, and/or (3) OpenAPI document to generate tests for specific endpoints. When providing an OpenAPI document, a matcher is required to specify which endpoints to generate tests for.",
     purpose: "Generate Pact tests for API interactions",
     inputSchema: GenerationInputSchema,
@@ -15,6 +16,7 @@ const TOOLS = [
   },
   {
     title: "Review Pact Tests",
+    toolset: "Review Pact Tests",
     summary: "Review Pact tests using PactFlow AI. You can provide the following inputs: (1) Pact tests to be reviewed along with metadata",
     purpose: "Review Pact tests for API interactions",
     inputSchema: RefineInputSchema,
@@ -25,6 +27,7 @@ const TOOLS = [
   },
   {
     title: "Get Provider States",
+    toolset: "Fetch Provider States",
     summary: "Retrieve the states of a specific provider",
     purpose: "A provider state in Pact defines the specific preconditions that must be met on the provider side before a consumer-provider interaction can be tested. It sets up the provider in the right context—such as ensuring a particular user or record exists—so that the provider can return the response the consumer expects. This makes contract tests reliable, repeatable, and isolated by injecting or configuring the necessary data and conditions directly into the provider before each test runs.",
     inputSchema: z.object({
@@ -35,6 +38,7 @@ const TOOLS = [
   },
   {
     title: "Can I Deploy",
+    toolset: "Can I Deploy",
     summary: "Performs a comprehensive compatibility check to determine whether a specific version of a service (pacticipant) can be safely deployed into a given environment. It analyzes the complete contract matrix of consumer-provider relationships to confirm that all required integrations are verified and compatible.",
     purpose: "To serve as a deployment safety check within the PactBroker and PactFlow ecosystem, leveraging contract testing results to validate whether a specific service / pacticipant version is compatible with all integrated services. This feature prevents unsafe releases, reduces integration risks, and enables teams to confidently automate deployments across environments with a clear, auditable record of verification results.",
     inputSchema: CanIDeploySchema,
@@ -43,6 +47,7 @@ const TOOLS = [
   },
   {
     title: "Matrix",
+    toolset: "Matrix",
     summary: "Retrieve the comprehensive contract verification matrix that shows the relationship between consumer and provider versions, their associated pact files, and verification results stored in the Pact Broker or Pactflow. The matrix provides detailed visibility into which consumer and provider versions have been successfully verified against each other, and highlights failures with detailed information about the cause.",
     purpose: "The Matrix serves as a powerful tool for teams to understand the state of their contract testing ecosystem. It enables tracking of all interactions between consumer and provider versions over time, with detailed insights into verification successes and failures. This helps teams rapidly identify compatibility issues, understand why specific verifications failed, and make informed decisions about deployments. Matrix offers a more intuitive and consolidated view of the verification status, making it easier to spot trends or problematic versions. Additionally, the Matrix supports complex queries using selectors, and can answer specific 'can-i-deploy' questions, ensuring that only compatible versions are deployed to production environments.",
     useCases: [
@@ -59,6 +64,7 @@ const TOOLS = [
   },
   {
     title: "Check PactFlow AI Entitlements",
+    toolset: "PactFlow AI Status",
     summary: "Check your PactFlow AI entitlements and credit balance if you encounter 401 Unauthorized errors or permission/credit issues when using PactFlow AI features.",
     purpose: "Retrieve AI entitlement information when PactFlow AI operations fail with 401 unauthorized errors. Use this to diagnose permission issues, check remaining credits, and verify account eligibility for AI features.",
     useCases: [
@@ -73,6 +79,7 @@ const TOOLS = [
   },
   {
     title: "Get Metrics",
+    toolset: "Metrics",
     summary: "Fetch metrics across the entire workspace",
     purpose: "Fetch metrics across the workspace. Use this to get an overview of contract testing usage, resource consumption and account-wide statistics.",
     inputSchema: z.object({}),
@@ -81,6 +88,7 @@ const TOOLS = [
   },
   {
     title: "Get Team Metrics",
+    toolset: "Metrics",
     summary: "Fetch metrics for all teams",
     purpose: "Fetch metrics for all teams within PactFlow. Use this to get an overview of team-specific contract testing usage, resource consumption and usage statistics.",
     inputSchema: z.object({}),
@@ -89,6 +97,7 @@ const TOOLS = [
   },
   {
     title: "List Pacticipants",
+    toolset: "Pacticipants",
     summary: "Retrieve all pacticipants (applications/services) registered in the Pact Broker or PactFlow workspace.",
     purpose: "Get an overview of all registered services and their metadata. Use this to discover what applications are participating in contract testing, check their main branches, and find repository URLs.",
     inputSchema: z.object({
@@ -100,6 +109,7 @@ const TOOLS = [
   },
   {
     title: "Get Pacticipant",
+    toolset: "Pacticipants",
     summary: "Retrieve details for a specific pacticipant by name.",
     purpose: "Fetch metadata for a single application/service including its display name, main branch, repository URL, and labels.",
     inputSchema: GetPacticipantSchema,
@@ -108,6 +118,7 @@ const TOOLS = [
   },
   {
     title: "List Branches",
+    toolset: "Branches and Versions",
     summary: "Retrieve all branches for a given pacticipant, with optional filtering and pagination.",
     purpose: "Explore the branches that have published pacts or verifications. Useful for understanding the active development lines of a service and for identifying stale branches to clean up.",
     inputSchema: ListBranchesSchema,
@@ -116,6 +127,7 @@ const TOOLS = [
   },
   {
     title: "List Pacticipant Versions",
+    toolset: "Branches and Versions",
     summary: "Retrieve all versions for a given pacticipant.",
     purpose: "List all published versions of a service with their branch and tag associations. Useful for understanding which versions exist and tracing deployment history.",
     inputSchema: ListVersionsSchema,
@@ -124,6 +136,7 @@ const TOOLS = [
   },
   {
     title: "Get Pacticipant Version",
+    toolset: "Branches and Versions",
     summary: "Retrieve details for a specific version of a pacticipant.",
     purpose: "Fetch metadata for a single version including its branches, tags, and build URL.",
     inputSchema: GetVersionSchema,
@@ -132,6 +145,7 @@ const TOOLS = [
   },
   {
     title: "Get Latest Pacticipant Version",
+    toolset: "Branches and Versions",
     summary: "Retrieve the latest version of a pacticipant, optionally filtered by tag.",
     purpose: "Quickly identify the most recent version of a service. When a tag is provided, returns the latest version that has that tag applied (e.g. the latest version tagged 'prod').",
     inputSchema: GetLatestVersionSchema,
@@ -140,6 +154,7 @@ const TOOLS = [
   },
   {
     title: "List Environments",
+    toolset: "Environments and Deployments",
     summary: "Retrieve all environments configured in the Pact Broker or PactFlow workspace.",
     purpose: "Get the list of deployment environments (e.g. development, staging, production) so you can use their UUIDs in record-deployment and can-i-deploy operations.",
     inputSchema: z.object({}),
@@ -148,6 +163,7 @@ const TOOLS = [
   },
   {
     title: "Get Environment",
+    toolset: "Environments and Deployments",
     summary: "Retrieve details for a specific environment by UUID.",
     purpose: "Fetch metadata for a single environment including its name, display name, production flag, and associated teams.",
     inputSchema: GetEnvironmentSchema,
@@ -156,6 +172,7 @@ const TOOLS = [
   },
   {
     title: "Record Deployment",
+    toolset: "Environments and Deployments",
     summary: "Record that a version of a pacticipant has been deployed to an environment.",
     purpose: "Inform PactFlow/Pact Broker of a successful deployment so that can-i-deploy checks and contract verification can use real deployment state. This is a key step in the PactFlow deployment workflow — run it after each successful deploy to keep the deployment state accurate.",
     inputSchema: RecordDeploymentSchema,
@@ -164,6 +181,7 @@ const TOOLS = [
   },
   {
     title: "Get Currently Deployed Versions",
+    toolset: "Environments and Deployments",
     summary: "Retrieve all versions currently deployed to a given environment.",
     purpose: "Check which versions of all services are currently running in an environment. Useful for auditing the state of an environment or for troubleshooting deployment issues.",
     inputSchema: GetCurrentlyDeployedSchema,
@@ -172,6 +190,7 @@ const TOOLS = [
   },
   {
     title: "Record Release",
+    toolset: "Environments and Deployments",
     summary: "Record that a version of a pacticipant has been released to an environment (for mobile/library release workflows).",
     purpose: "Use for services that are 'released' rather than 'deployed' — e.g. mobile apps, libraries, or multi-version APIs where multiple versions coexist simultaneously. Unlike record-deployment (which marks previous versions as no longer deployed), record-release marks a version as currently supported without replacing prior versions.",
     inputSchema: RecordReleaseSchema,
@@ -180,6 +199,7 @@ const TOOLS = [
   },
   {
     title: "Get Currently Supported Versions",
+    toolset: "Environments and Deployments",
     summary: "Retrieve all versions currently released and supported in a given environment.",
     purpose: "Check which released versions are still actively supported in an environment. Important for mobile or library workflows where multiple versions are simultaneously in use.",
     inputSchema: GetCurrentlySupportedSchema,
@@ -188,6 +208,7 @@ const TOOLS = [
   },
   {
     title: "Publish Consumer Contracts",
+    toolset: "Contracts",
     summary: "Publish one or more consumer Pact contracts to the Pact Broker or PactFlow, with branch and tag metadata.",
     purpose: "Upload consumer-driven contract files after running consumer tests. Associate each contract with a branch and version number so that PactFlow can match it to provider verification results and enable can-i-deploy checks.",
     inputSchema: PublishConsumerContractsSchema,
@@ -196,6 +217,7 @@ const TOOLS = [
   },
   {
     title: "Publish Provider Contract",
+    toolset: "Contracts",
     summary: "Publish a provider OpenAPI contract and self-verification results to PactFlow (Bi-Directional Contract Testing).",
     purpose: "Upload an OpenAPI specification as a provider contract along with the results of running a tool (e.g. Dredd, Schemathesis) that verifies the provider implementation against the spec. This enables PactFlow to perform automated cross-contract verification without requiring the provider to run the consumer Pact tests.",
     inputSchema: PublishProviderContractSchema,
@@ -204,6 +226,7 @@ const TOOLS = [
   },
   {
     title: "Get Pacts for Verification",
+    toolset: "Contracts",
     summary: "Retrieve the pacts that a provider should verify, based on consumer version selectors and WIP/pending pact configuration.",
     purpose: "Fetch the exact set of consumer pacts that a provider needs to verify in its current CI run. Use consumer version selectors to control which consumer branches and environments are included. Enable WIP pacts to get early feedback on new consumer interactions without breaking the provider build.",
     inputSchema: GetPactsForVerificationSchema,
@@ -212,6 +235,7 @@ const TOOLS = [
   },
   {
     title: "Get BDCT Provider Contract",
+    toolset: "Bi-Directional Contract Testing",
     summary: "Fetch the provider OpenAPI contract for a given provider version in Bi-Directional Contract Testing.",
     purpose: "Retrieve the OpenAPI specification that was published as the provider contract for a specific version. Also returns the verification status of that contract against all consumer pacts.",
     inputSchema: GetBiDirectionalProviderVersionSchema,
@@ -220,6 +244,7 @@ const TOOLS = [
   },
   {
     title: "Get BDCT Provider Contract Verification Results",
+    toolset: "Bi-Directional Contract Testing",
     summary: "Fetch the self-verification results for a provider contract version in Bi-Directional Contract Testing.",
     purpose: "Retrieve the results of the tool (e.g. Dredd, Schemathesis) that verified the provider implementation against its own OpenAPI spec. Use this to understand whether the provider passed its self-verification step.",
     inputSchema: GetBiDirectionalProviderVersionSchema,
@@ -228,6 +253,7 @@ const TOOLS = [
   },
   {
     title: "Get BDCT Consumer Contracts",
+    toolset: "Bi-Directional Contract Testing",
     summary: "Fetch all consumer Pact contracts relevant to a given provider version in Bi-Directional Contract Testing.",
     purpose: "Retrieve the consumer-side Pact contracts that PactFlow compared against the provider's OpenAPI spec for a specific provider version. Useful for understanding which consumer interactions triggered a cross-contract verification.",
     inputSchema: GetBiDirectionalProviderVersionSchema,
@@ -236,6 +262,7 @@ const TOOLS = [
   },
   {
     title: "Get BDCT Consumer Contract Verification Results",
+    toolset: "Bi-Directional Contract Testing",
     summary: "Fetch the consumer contract verification results for a given provider version in Bi-Directional Contract Testing.",
     purpose: "Retrieve the results of comparing all consumer Pact contracts against the provider's OpenAPI spec for a specific provider version. Shows whether each consumer interaction is covered by the spec.",
     inputSchema: GetBiDirectionalProviderVersionSchema,
@@ -244,6 +271,7 @@ const TOOLS = [
   },
   {
     title: "Get BDCT Cross-Contract Verification Results",
+    toolset: "Bi-Directional Contract Testing",
     summary: "Fetch the cross-contract verification results for a given provider version in Bi-Directional Contract Testing.",
     purpose: "Retrieve the combined results of PactFlow's automated cross-contract comparison for a specific provider version — the outcome of comparing the provider's OpenAPI spec against all relevant consumer Pact files. This is the key result that determines whether can-i-deploy will pass.",
     inputSchema: GetBiDirectionalProviderVersionSchema,
@@ -252,6 +280,7 @@ const TOOLS = [
   },
   {
     title: "Get BDCT Consumer by Consumer Version",
+    toolset: "Bi-Directional Contract Testing",
     summary: "Fetch the consumer Pact contract for a specific consumer-provider version pair in Bi-Directional Contract Testing.",
     purpose: "Retrieve the Pact contract published by a specific consumer version, in the context of a specific provider version. Use this when you need the exact consumer contract that was compared against a given provider spec.",
     inputSchema: GetBiDirectionalConsumerProviderVersionSchema,
@@ -260,6 +289,7 @@ const TOOLS = [
   },
   {
     title: "Get BDCT Provider by Consumer Version",
+    toolset: "Bi-Directional Contract Testing",
     summary: "Fetch the provider OpenAPI contract for a specific consumer-provider version pair in Bi-Directional Contract Testing.",
     purpose: "Retrieve the provider's OpenAPI spec in the context of a specific consumer version pair. Useful when investigating why a particular consumer-provider combination failed cross-contract verification.",
     inputSchema: GetBiDirectionalConsumerProviderVersionSchema,
@@ -268,6 +298,7 @@ const TOOLS = [
   },
   {
     title: "Get BDCT Provider Check Results by Consumer",
+    toolset: "Bi-Directional Contract Testing",
     summary: "Fetch the provider contract self-verification results for a specific consumer-provider version pair in Bi-Directional Contract Testing.",
     purpose: "Retrieve the provider's self-verification results in the context of a specific consumer version pair. Use when diagnosing failures for a particular consumer-provider combination.",
     inputSchema: GetBiDirectionalConsumerProviderVersionSchema,
@@ -276,6 +307,7 @@ const TOOLS = [
   },
   {
     title: "Get BDCT Consumer Pact Test Results by Consumer",
+    toolset: "Bi-Directional Contract Testing",
     summary: "Fetch the consumer contract verification results for a specific consumer-provider version pair in Bi-Directional Contract Testing.",
     purpose: "Retrieve the results of comparing a specific consumer version's Pact against the provider's OpenAPI spec. Shows exactly which interactions passed or failed the cross-contract comparison.",
     inputSchema: GetBiDirectionalConsumerProviderVersionSchema,
@@ -284,6 +316,7 @@ const TOOLS = [
   },
   {
     title: "Get BDCT X-Contract Test Results by Consumer",
+    toolset: "Bi-Directional Contract Testing",
     summary: "Fetch the cross-contract verification results for a specific consumer-provider version pair in Bi-Directional Contract Testing.",
     purpose: "Retrieve the precise cross-contract comparison outcome between a specific consumer version and provider version. This is the most granular BDCT result — use it to understand exactly why a specific consumer-provider pairing succeeded or failed, and which interactions were incompatible.",
     inputSchema: GetBiDirectionalConsumerProviderVersionSchema,
@@ -292,6 +325,7 @@ const TOOLS = [
   },
   {
     title: "List Integrations",
+    toolset: "Integrations and Network",
     summary: "Retrieve all consumer-provider integrations registered in the workspace.",
     purpose: "Get a high-level view of all the consumer-provider pairings that have pacts published. An integration is automatically created when a consumer publishes a pact for a provider.",
     inputSchema: z.object({}),
@@ -300,6 +334,7 @@ const TOOLS = [
   },
   {
     title: "Get Pacticipant Network",
+    toolset: "Integrations and Network",
     summary: "Retrieve the integration network graph for a specific pacticipant.",
     purpose: "Visualise all the consumer-provider relationships for a service — both the services it consumes and the consumers that depend on it. Use this to understand the blast radius of changes to a service.",
     inputSchema: GetPacticipantNetworkSchema,
@@ -308,6 +343,7 @@ const TOOLS = [
   },
   {
     title: "List Labels",
+    toolset: "Labels",
     summary: "Retrieve all labels used across the workspace.",
     purpose: "Get a list of every label that has been applied to any pacticipant. Labels are used to categorise services and enable label-based queries.",
     inputSchema: z.object({
@@ -319,6 +355,7 @@ const TOOLS = [
   },
   {
     title: "Get Pacticipant Label",
+    toolset: "Labels",
     summary: "Check whether a specific label is applied to a pacticipant.",
     purpose: "Verify that a label exists on a pacticipant. Returns 404 if the label is not applied.",
     inputSchema: GetLabelSchema,
@@ -327,6 +364,7 @@ const TOOLS = [
   },
   {
     title: "List Pacticipants by Label",
+    toolset: "Labels",
     summary: "Retrieve all pacticipants that have a specific label applied.",
     purpose: "Filter the pacticipant list by label. Useful for querying services by team ownership, technology, or any custom grouping you have applied via labels.",
     inputSchema: LabelByNameSchema,
@@ -335,6 +373,7 @@ const TOOLS = [
   },
   {
     title: "Update Pacticipant",
+    toolset: "Pacticipants",
     summary: "Fully replace a pacticipant's metadata (display name, main branch, repository URL, etc.).",
     purpose: "Update a service's metadata with a full replacement. All fields not provided will be cleared. Use Patch Pacticipant instead if you only want to update specific fields.",
     inputSchema: UpdatePacticipantSchema,
@@ -343,6 +382,7 @@ const TOOLS = [
   },
   {
     title: "Patch Pacticipant",
+    toolset: "Pacticipants",
     summary: "Partially update a pacticipant's metadata — only fields provided are changed.",
     purpose: "Update one or more properties of a service without affecting the others. Prefer this over Update Pacticipant when you only need to change a specific field such as the main branch.",
     inputSchema: UpdatePacticipantSchema,
@@ -351,6 +391,7 @@ const TOOLS = [
   },
   {
     title: "Update Pacticipant Version",
+    toolset: "Branches and Versions",
     summary: "Update metadata for a specific pacticipant version.",
     purpose: "Set or update the build URL for an existing version. This is useful when the build URL was not available at publish time.",
     inputSchema: UpdateVersionSchema,
@@ -359,6 +400,7 @@ const TOOLS = [
   },
   {
     title: "Get Branch Versions",
+    toolset: "Branches and Versions",
     summary: "Retrieve all versions published from a specific branch of a pacticipant.",
     purpose: "List the history of versions for a particular branch. Useful for understanding which versions were created on a feature branch before it was merged.",
     inputSchema: GetBranchVersionsSchema,
@@ -367,6 +409,7 @@ const TOOLS = [
   },
   {
     title: "Get Deployed Versions for Version",
+    toolset: "Environments and Deployments",
     summary: "Retrieve deployment records for a specific pacticipant version in a specific environment.",
     purpose: "Check the deployment history for a particular version in a given environment. Returns all deployment records including whether each is currently active.",
     inputSchema: GetVersionDeployedSchema,
@@ -375,6 +418,7 @@ const TOOLS = [
   },
   {
     title: "Get Released Versions for Version",
+    toolset: "Environments and Deployments",
     summary: "Retrieve release records for a specific pacticipant version in a specific environment.",
     purpose: "Check the release history for a particular version in a given environment. Used in mobile/library workflows to see all release records for a version.",
     inputSchema: GetVersionDeployedSchema,
@@ -383,6 +427,7 @@ const TOOLS = [
   },
   {
     title: "Create Environment",
+    toolset: "Environments and Deployments",
     summary: "Create a new deployment environment in PactFlow.",
     purpose: "Register a new environment (e.g. 'staging', 'production') so it can be used in record-deployment and can-i-deploy workflows.",
     inputSchema: CreateEnvironmentSchema,
@@ -391,6 +436,7 @@ const TOOLS = [
   },
   {
     title: "Update Environment",
+    toolset: "Environments and Deployments",
     summary: "Update an existing environment's metadata.",
     purpose: "Rename an environment, change its production flag, or update team assignments.",
     inputSchema: UpdateEnvironmentSchema,
@@ -399,6 +445,7 @@ const TOOLS = [
   },
   {
     title: "Delete Environment",
+    toolset: "Environments and Deployments",
     summary: "Delete an environment by UUID.",
     purpose: "Remove an environment that is no longer needed. This will also remove all deployed and released version records for this environment.",
     inputSchema: GetEnvironmentSchema,
@@ -407,6 +454,7 @@ const TOOLS = [
   },
   {
     title: "Create Pacticipant",
+    toolset: "Pacticipants",
     summary: "Register a new application/service (pacticipant) in the workspace.",
     purpose: "Create a pacticipant entry before publishing contracts or recording deployments. The name cannot be changed after creation.",
     inputSchema: CreatePacticipantSchema,
@@ -415,6 +463,7 @@ const TOOLS = [
   },
   {
     title: "Delete Pacticipant",
+    toolset: "Pacticipants",
     summary: "Delete a pacticipant and all its associated data.",
     purpose: "Remove a service from the workspace, including all its pacts, verifications, deployments, and version records.",
     inputSchema: DeletePacticipantSchema,
@@ -423,6 +472,7 @@ const TOOLS = [
   },
   {
     title: "Get Branch",
+    toolset: "Branches and Versions",
     summary: "Retrieve details for a specific branch of a pacticipant.",
     purpose: "Fetch metadata for a single branch, including its latest version.",
     inputSchema: GetBranchSchema,
@@ -431,6 +481,7 @@ const TOOLS = [
   },
   {
     title: "Delete Branch",
+    toolset: "Branches and Versions",
     summary: "Delete a branch from a pacticipant.",
     purpose: "Remove a stale branch record. This does not delete the versions or pacts published from the branch.",
     inputSchema: DeleteBranchSchema,
@@ -439,6 +490,7 @@ const TOOLS = [
   },
   {
     title: "Add Label to Pacticipant",
+    toolset: "Labels",
     summary: "Apply a label to a pacticipant.",
     purpose: "Tag a service with a label for grouping and filtering. Creates the label if it does not already exist.",
     inputSchema: ManageLabelSchema,
@@ -447,6 +499,7 @@ const TOOLS = [
   },
   {
     title: "Remove Label from Pacticipant",
+    toolset: "Labels",
     summary: "Remove a label from a pacticipant.",
     purpose: "Delete the label association from a pacticipant. Does not affect other pacticipants that have the same label.",
     inputSchema: ManageLabelSchema,
@@ -455,6 +508,7 @@ const TOOLS = [
   },
   {
     title: "Get Integrations by Team",
+    toolset: "Integrations and Network",
     summary: "Retrieve all consumer-provider integrations belonging to a specific team.",
     purpose: "Filter the integration list by team ownership to see only the pairings relevant to a given team.",
     inputSchema: GetIntegrationsByTeamSchema,
@@ -463,6 +517,7 @@ const TOOLS = [
   },
   {
     title: "Delete Integration",
+    toolset: "Integrations and Network",
     summary: "Delete a specific consumer-provider integration.",
     purpose: "Remove the integration record between a consumer and provider. Use with caution — this removes the link even if pacts exist.",
     inputSchema: DeleteIntegrationSchema,
@@ -471,6 +526,7 @@ const TOOLS = [
   },
   {
     title: "Delete All Integrations",
+    toolset: "Integrations and Network",
     summary: "Delete ALL consumer-provider integrations in the workspace.",
     purpose: "Bulk-remove all integration records. This is a destructive operation — use only when resetting the workspace.",
     inputSchema: z.object({}),
@@ -479,6 +535,7 @@ const TOOLS = [
   },
   {
     title: "List Webhooks",
+    toolset: "Webhooks",
     summary: "Retrieve all webhooks configured in the workspace.",
     purpose: "Get an overview of all webhook triggers, their target URLs, and enabled/disabled status.",
     inputSchema: z.object({}),
@@ -487,6 +544,7 @@ const TOOLS = [
   },
   {
     title: "Get Webhook",
+    toolset: "Webhooks",
     summary: "Retrieve details for a specific webhook by UUID.",
     purpose: "Fetch the full configuration of a single webhook including events, request details, and consumer/provider filters.",
     inputSchema: WebhookIdSchema,
@@ -495,6 +553,7 @@ const TOOLS = [
   },
   {
     title: "Create Webhook",
+    toolset: "Webhooks",
     summary: "Create a new webhook to trigger on contract events.",
     purpose: "Set up automated notifications or CI triggers that fire when contracts change, verifications are published, or other events occur.",
     inputSchema: CreateWebhookSchema,
@@ -503,6 +562,7 @@ const TOOLS = [
   },
   {
     title: "Update Webhook",
+    toolset: "Webhooks",
     summary: "Update an existing webhook's configuration.",
     purpose: "Modify the URL, events, consumer/provider filters, or enabled status of a webhook.",
     inputSchema: UpdateWebhookSchema,
@@ -511,6 +571,7 @@ const TOOLS = [
   },
   {
     title: "Delete Webhook",
+    toolset: "Webhooks",
     summary: "Delete a webhook by UUID.",
     purpose: "Permanently remove a webhook. Any in-flight triggered executions will still complete.",
     inputSchema: WebhookIdSchema,
@@ -519,6 +580,7 @@ const TOOLS = [
   },
   {
     title: "Test Execute Webhooks",
+    toolset: "Webhooks",
     summary: "Trigger a test execution of all matching webhooks without a real event.",
     purpose: "Verify webhook configuration by sending a test request. Useful for debugging URL, auth, or body template issues.",
     inputSchema: z.object({}),
@@ -527,6 +589,7 @@ const TOOLS = [
   },
   {
     title: "Execute Webhook",
+    toolset: "Webhooks",
     summary: "Trigger a test execution of a specific webhook.",
     purpose: "Send a test request for a single webhook to verify its configuration without waiting for a real event.",
     inputSchema: WebhookIdSchema,
@@ -535,6 +598,7 @@ const TOOLS = [
   },
   {
     title: "List Secrets",
+    toolset: "Secrets",
     summary: "Retrieve all secrets stored in the workspace.",
     purpose: "Get an overview of all configured secrets. Note: secret values are never returned — only metadata.",
     inputSchema: z.object({}),
@@ -543,6 +607,7 @@ const TOOLS = [
   },
   {
     title: "Get Secret",
+    toolset: "Secrets",
     summary: "Retrieve metadata for a specific secret by UUID.",
     purpose: "Fetch secret metadata (name, description, team). The secret value is never returned.",
     inputSchema: SecretIdSchema,
@@ -551,6 +616,7 @@ const TOOLS = [
   },
   {
     title: "Create Secret",
+    toolset: "Secrets",
     summary: "Create a new secret for use in webhook authentication.",
     purpose: "Store a sensitive value (API key, password, token) securely. The value can be referenced in webhook configurations without exposing it.",
     inputSchema: CreateSecretSchema,
@@ -559,6 +625,7 @@ const TOOLS = [
   },
   {
     title: "Update Secret",
+    toolset: "Secrets",
     summary: "Update an existing secret's name, value, or description.",
     purpose: "Rotate or rename a secret. The team assignment cannot be changed after creation.",
     inputSchema: UpdateSecretSchema,
@@ -567,6 +634,7 @@ const TOOLS = [
   },
   {
     title: "Delete Secret",
+    toolset: "Secrets",
     summary: "Delete a secret by UUID.",
     purpose: "Permanently remove a secret. Any webhooks referencing this secret will need to be updated.",
     inputSchema: SecretIdSchema,
@@ -575,6 +643,7 @@ const TOOLS = [
   },
   {
     title: "Get Current User",
+    toolset: "User, Tokens and Preferences",
     summary: "Retrieve the profile of the currently authenticated user.",
     purpose: "Check who you are authenticated as, including your UUID, name, email, and roles.",
     inputSchema: z.object({}),
@@ -583,6 +652,7 @@ const TOOLS = [
   },
   {
     title: "List API Tokens",
+    toolset: "User, Tokens and Preferences",
     summary: "Retrieve API tokens for the current user.",
     purpose: "List the read-only and read-write API tokens for the authenticated user.",
     inputSchema: z.object({}),
@@ -591,6 +661,7 @@ const TOOLS = [
   },
   {
     title: "Regenerate API Token",
+    toolset: "User, Tokens and Preferences",
     summary: "Regenerate (rotate) an API token by ID.",
     purpose: "Invalidate the current token and generate a new one. Use when a token has been compromised.",
     inputSchema: RegenerateTokenSchema,
@@ -599,6 +670,7 @@ const TOOLS = [
   },
   {
     title: "Get User Preferences",
+    toolset: "User, Tokens and Preferences",
     summary: "Retrieve the current user's preferences.",
     purpose: "Fetch all preference settings for the authenticated user.",
     inputSchema: z.object({}),
@@ -607,6 +679,7 @@ const TOOLS = [
   },
   {
     title: "Get System Preferences",
+    toolset: "User, Tokens and Preferences",
     summary: "Retrieve system-wide preferences.",
     purpose: "Fetch all system-level preference settings for the workspace.",
     inputSchema: z.object({}),
@@ -615,6 +688,7 @@ const TOOLS = [
   },
   {
     title: "Get Audit Log",
+    toolset: "Audit",
     summary: "Retrieve the audit log of events in the workspace.",
     purpose: "Search and filter the audit trail of actions taken in PactFlow. Useful for compliance, debugging, and security reviews.",
     useCases: [
@@ -629,6 +703,7 @@ const TOOLS = [
   },
   {
     title: "Admin List Users",
+    toolset: "Admin",
     summary: "List all users in the workspace (admin).",
     purpose: "Get an overview of all user accounts with optional filtering by active status, name/email, or user type.",
     inputSchema: ListAdminUsersSchema,
@@ -637,6 +712,7 @@ const TOOLS = [
   },
   {
     title: "Admin Get User",
+    toolset: "Admin",
     summary: "Retrieve details for a specific user by UUID (admin).",
     purpose: "Fetch a user's profile including their email, name, roles, and active status.",
     inputSchema: AdminUserIdSchema,
@@ -645,6 +721,7 @@ const TOOLS = [
   },
   {
     title: "Admin Create User",
+    toolset: "Admin",
     summary: "Create a new user account (admin).",
     purpose: "Add a new user to the workspace. For SSO environments, provide externalIdpId or externalIdpUsername to match the IdP identity.",
     inputSchema: CreateAdminUserSchema,
@@ -653,6 +730,7 @@ const TOOLS = [
   },
   {
     title: "Admin Update User",
+    toolset: "Admin",
     summary: "Update a user's profile or active status (admin).",
     purpose: "Modify user details such as name, email, or active status. Deactivating a user prevents them from logging in.",
     inputSchema: UpdateAdminUserSchema,
@@ -661,6 +739,7 @@ const TOOLS = [
   },
   {
     title: "Admin Delete User",
+    toolset: "Admin",
     summary: "Delete a user account (admin).",
     purpose: "Permanently remove a user from the workspace.",
     inputSchema: AdminUserIdSchema,
@@ -669,6 +748,7 @@ const TOOLS = [
   },
   {
     title: "Admin Invite Users",
+    toolset: "Admin",
     summary: "Send invitations to new users (admin).",
     purpose: "Invite one or more people to join the workspace by email. They will receive an invitation email.",
     inputSchema: InviteUsersSchema,
@@ -677,6 +757,7 @@ const TOOLS = [
   },
   {
     title: "Admin Set User Roles",
+    toolset: "Admin",
     summary: "Replace all roles assigned to a user (admin).",
     purpose: "Fully replace the set of roles for a user. All existing roles are removed and replaced with the provided list.",
     inputSchema: SetUserRolesSchema,
@@ -685,6 +766,7 @@ const TOOLS = [
   },
   {
     title: "Admin Add Role to User",
+    toolset: "Admin",
     summary: "Add a single role to a user (admin).",
     purpose: "Grant an additional role to a user without affecting their existing roles.",
     inputSchema: UserRoleSchema,
@@ -693,6 +775,7 @@ const TOOLS = [
   },
   {
     title: "Admin Remove Role from User",
+    toolset: "Admin",
     summary: "Remove a single role from a user (admin).",
     purpose: "Revoke a specific role from a user without affecting their other roles.",
     inputSchema: UserRoleSchema,
@@ -701,6 +784,7 @@ const TOOLS = [
   },
   {
     title: "Admin List Teams",
+    toolset: "Admin",
     summary: "List all teams in the workspace (admin).",
     purpose: "Get an overview of all teams with optional name filtering and pagination.",
     inputSchema: ListAdminTeamsSchema,
@@ -709,6 +793,7 @@ const TOOLS = [
   },
   {
     title: "Admin Get Team",
+    toolset: "Admin",
     summary: "Retrieve details for a specific team by UUID (admin).",
     purpose: "Fetch a team's configuration including its name, members, environments, and pacticipants.",
     inputSchema: AdminTeamIdSchema,
@@ -717,6 +802,7 @@ const TOOLS = [
   },
   {
     title: "Admin Create Team",
+    toolset: "Admin",
     summary: "Create a new team (admin).",
     purpose: "Add a new team to the workspace and optionally assign administrators, environments, and pacticipants.",
     inputSchema: CreateTeamSchema,
@@ -725,6 +811,7 @@ const TOOLS = [
   },
   {
     title: "Admin Update Team",
+    toolset: "Admin",
     summary: "Replace a team's configuration (admin).",
     purpose: "Fully update a team's name, administrators, environments, and pacticipant assignments.",
     inputSchema: UpdateTeamSchema,
@@ -733,6 +820,7 @@ const TOOLS = [
   },
   {
     title: "Admin Delete Team",
+    toolset: "Admin",
     summary: "Delete a team (admin).",
     purpose: "Permanently remove a team from the workspace. Members are not deleted.",
     inputSchema: AdminTeamIdSchema,
@@ -741,6 +829,7 @@ const TOOLS = [
   },
   {
     title: "Admin List Team Users",
+    toolset: "Admin",
     summary: "List all users in a specific team (admin).",
     purpose: "Retrieve all user members of a team.",
     inputSchema: AdminTeamIdSchema,
@@ -749,6 +838,7 @@ const TOOLS = [
   },
   {
     title: "Admin Get Team User",
+    toolset: "Admin",
     summary: "Check if a specific user is a member of a team (admin).",
     purpose: "Verify team membership for a user. Returns 404 if the user is not in the team.",
     inputSchema: TeamUserIdSchema,
@@ -757,6 +847,7 @@ const TOOLS = [
   },
   {
     title: "Admin Set Team Users",
+    toolset: "Admin",
     summary: "Replace all members of a team (admin).",
     purpose: "Fully replace the set of users in a team. All existing members are removed and replaced with the provided list.",
     inputSchema: SetTeamUsersSchema,
@@ -765,6 +856,7 @@ const TOOLS = [
   },
   {
     title: "Admin Patch Team Users",
+    toolset: "Admin",
     summary: "Add or remove individual users from a team using JSON Patch (admin).",
     purpose: "Make targeted changes to team membership — add specific users or remove them — without replacing the entire member list.",
     inputSchema: PatchTeamUsersSchema,
@@ -773,6 +865,7 @@ const TOOLS = [
   },
   {
     title: "Admin Remove User from Team",
+    toolset: "Admin",
     summary: "Remove a specific user from a team (admin).",
     purpose: "Revoke team membership for a user.",
     inputSchema: TeamUserIdSchema,
@@ -781,6 +874,7 @@ const TOOLS = [
   },
   {
     title: "Admin List Roles",
+    toolset: "Admin",
     summary: "List all roles defined in the workspace (admin).",
     purpose: "Get an overview of all role definitions and their associated permissions.",
     inputSchema: z.object({}),
@@ -789,6 +883,7 @@ const TOOLS = [
   },
   {
     title: "Admin Get Role",
+    toolset: "Admin",
     summary: "Retrieve details for a specific role by UUID (admin).",
     purpose: "Fetch a role's name, description, and full list of permission scopes.",
     inputSchema: AdminRoleIdSchema,
@@ -797,6 +892,7 @@ const TOOLS = [
   },
   {
     title: "Admin Create Role",
+    toolset: "Admin",
     summary: "Create a new role with specific permissions (admin).",
     purpose: "Define a custom role with a tailored set of permission scopes. Roles can then be assigned to users.",
     inputSchema: CreateRoleSchema,
@@ -805,6 +901,7 @@ const TOOLS = [
   },
   {
     title: "Admin Update Role",
+    toolset: "Admin",
     summary: "Update an existing role's name and permissions (admin).",
     purpose: "Modify the permission set of a role. Changes take effect for all users assigned the role.",
     inputSchema: UpdateRoleSchema,
@@ -813,6 +910,7 @@ const TOOLS = [
   },
   {
     title: "Admin Delete Role",
+    toolset: "Admin",
     summary: "Delete a role (admin).",
     purpose: "Permanently remove a role. Users currently assigned this role will lose its permissions.",
     inputSchema: AdminRoleIdSchema,
@@ -821,6 +919,7 @@ const TOOLS = [
   },
   {
     title: "Admin Reset Roles",
+    toolset: "Admin",
     summary: "Reset all roles to their factory defaults (admin).",
     purpose: "Restore the built-in roles to their original permission sets. Custom roles are removed.",
     inputSchema: z.object({}),
@@ -829,6 +928,7 @@ const TOOLS = [
   },
   {
     title: "Admin List Permissions",
+    toolset: "Admin",
     summary: "List all available permission scopes (admin).",
     purpose: "Retrieve all permission scopes that can be assigned to roles.",
     inputSchema: z.object({}),
@@ -837,6 +937,7 @@ const TOOLS = [
   },
   {
     title: "Admin Create System Account",
+    toolset: "Admin",
     summary: "Create a new system account (admin).",
     purpose: "Add a machine/service account that can authenticate via API token rather than user credentials.",
     inputSchema: CreateSystemAccountSchema,
@@ -845,6 +946,7 @@ const TOOLS = [
   },
   {
     title: "Admin Get System Account Tokens",
+    toolset: "Admin",
     summary: "Retrieve API tokens for a system account (admin).",
     purpose: "Get the tokens associated with a system account for use in CI/CD pipelines.",
     inputSchema: GetSystemAccountTokensSchema,