itglue-mcp 1.3.0 → 1.3.2

package/dist/index.js

@@ -13,14 +13,14 @@ import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextpro
 import { APIClient } from './lib/api-client.js';
 import { AuditLogger } from './lib/audit-logger.js';
 // Import tool schemas and handlers
-import { SearchOrganizationsSchema, ListOrganizationTypesSchema, searchOrganizations, listOrganizationTypes, } from './tools/organizations.js';
+import { SearchOrganizationsSchema, ListOrganizationTypesSchema, UpdateOrganizationSchema, searchOrganizations, listOrganizationTypes, updateOrganization, } from './tools/organizations.js';
 import { GlobalSearchSchema, globalSearch } from './tools/search.js';
-import { ListConfigurationsSchema, listConfigurations } from './tools/configurations.js';
-import { ListPasswordsSchema, GetPasswordSchema, listPasswords, getPassword, } from './tools/passwords.js';
-import { ListFlexibleAssetsSchema, GetFlexibleAssetSchema, listFlexibleAssets, getFlexibleAsset, } from './tools/flexible-assets.js';
+import { ListConfigurationsSchema, CreateConfigurationSchema, UpdateConfigurationSchema, listConfigurations, createConfiguration, updateConfiguration, } from './tools/configurations.js';
+import { ListPasswordsSchema, GetPasswordSchema, CreatePasswordSchema, UpdatePasswordSchema, listPasswords, getPassword, createPassword, updatePassword, } from './tools/passwords.js';
+import { ListFlexibleAssetTypesSchema, ListFlexibleAssetsSchema, GetFlexibleAssetSchema, CreateFlexibleAssetSchema, UpdateFlexibleAssetSchema, listFlexibleAssetTypes, listFlexibleAssets, getFlexibleAsset, createFlexibleAsset, updateFlexibleAsset, } from './tools/flexible-assets.js';
 import { ListDocumentsSchema, listDocuments } from './tools/documents.js';
-import { ListContactsArgsSchema, listContacts } from './tools/contacts.js';
-import { ListLocationsArgsSchema, listLocations } from './tools/locations.js';
+import { ListContactsArgsSchema, CreateContactSchema, UpdateContactSchema, listContacts, createContact, updateContact, } from './tools/contacts.js';
+import { ListLocationsArgsSchema, CreateLocationSchema, UpdateLocationSchema, listLocations, createLocation, updateLocation, } from './tools/locations.js';
 import { ListAttachmentsArgsSchema, listAttachments } from './tools/attachments.js';
 import { ListConfigurationInterfacesArgsSchema, listConfigurationInterfaces, } from './tools/configuration-interfaces.js';
 import { GetRelatedItemsArgsSchema, getRelatedItems } from './tools/related-items.js';
@@ -110,6 +110,13 @@ async function main() {
                                 },
                             },
                         },
+                        annotations: {
+                            title: 'Search Organizations',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     {
                         name: 'itglue_list_organization_types',
@@ -118,6 +125,13 @@ async function main() {
                             type: 'object',
                             properties: {},
                         },
+                        annotations: {
+                            title: 'List Organization Types',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     {
                         name: 'itglue_search_global',
@@ -139,6 +153,34 @@ async function main() {
                             },
                             required: ['query'],
                         },
+                        annotations: {
+                            title: 'Global Search',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
+                    },
+                    {
+                        name: 'itglue_list_flexible_asset_types',
+                        description: 'List all flexible asset types (custom documentation categories like "Network", "Application", "Backup"). Returns type IDs needed for itglue_list_flexible_assets. Optionally includes field definitions for each type.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                include_fields: {
+                                    type: 'boolean',
+                                    description: 'Include field definitions (name, kind, required) for each type',
+                                    default: false,
+                                },
+                            },
+                        },
+                        annotations: {
+                            title: 'List Flexible Asset Types',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     // Tier 2: Entity Navigation
                     {
@@ -169,6 +211,13 @@ async function main() {
                             },
                             required: ['organization_id'],
                         },
+                        annotations: {
+                            title: 'List Configurations',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     {
                         name: 'itglue_list_passwords',
@@ -194,6 +243,13 @@ async function main() {
                             },
                             required: ['organization_id'],
                         },
+                        annotations: {
+                            title: 'List Passwords',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     {
                         name: 'itglue_list_flexible_assets',
@@ -219,6 +275,13 @@ async function main() {
                             },
                             required: ['organization_id', 'flexible_asset_type_id'],
                         },
+                        annotations: {
+                            title: 'List Flexible Assets',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     {
                         name: 'itglue_list_documents',
@@ -240,6 +303,13 @@ async function main() {
                             },
                             required: ['organization_id'],
                         },
+                        annotations: {
+                            title: 'List Documents',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     {
                         name: 'itglue_list_contacts',
@@ -265,6 +335,13 @@ async function main() {
                             },
                             required: ['organization_id'],
                         },
+                        annotations: {
+                            title: 'List Contacts',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     {
                         name: 'itglue_list_locations',
@@ -286,6 +363,13 @@ async function main() {
                             },
                             required: ['organization_id'],
                         },
+                        annotations: {
+                            title: 'List Locations',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     {
                         name: 'itglue_list_attachments',
@@ -319,6 +403,13 @@ async function main() {
                             },
                             required: ['resource_type', 'resource_id'],
                         },
+                        annotations: {
+                            title: 'List Attachments',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     {
                         name: 'itglue_list_configuration_interfaces',
@@ -340,6 +431,13 @@ async function main() {
                             },
                             required: ['configuration_id'],
                         },
+                        annotations: {
+                            title: 'List Configuration Interfaces',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     {
                         name: 'itglue_get_related_items',
@@ -366,6 +464,13 @@ async function main() {
                             },
                             required: ['resource_type', 'resource_id'],
                         },
+                        annotations: {
+                            title: 'Get Related Items',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     // Tier 3: Detail Retrieval
                     {
@@ -390,6 +495,13 @@ async function main() {
                             },
                             required: ['password_id'],
                         },
+                        annotations: {
+                            title: 'Get Password',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     {
                         name: 'itglue_get_flexible_asset',
@@ -408,6 +520,13 @@ async function main() {
                             },
                             required: ['flexible_asset_id'],
                         },
+                        annotations: {
+                            title: 'Get Flexible Asset',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     // Auxiliary Tools: Audit & Compliance
                     {
@@ -432,6 +551,13 @@ async function main() {
                             },
                             required: ['organization_id'],
                         },
+                        annotations: {
+                            title: 'Compliance Check',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     // Auxiliary Tools: Staleness Detection
                     {
@@ -468,6 +594,13 @@ async function main() {
                             },
                             required: ['organization_id'],
                         },
+                        annotations: {
+                            title: 'Detect Staleness',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     // Auxiliary Tools: Data Validation
                     {
@@ -492,6 +625,13 @@ async function main() {
                             },
                             required: ['organization_id'],
                         },
+                        annotations: {
+                            title: 'Validate Data',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     // Auxiliary Tools: Reporting
                     {
@@ -518,6 +658,296 @@ async function main() {
                             },
                             required: ['organization_id'],
                         },
+                        annotations: {
+                            title: 'Generate Report',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
+                    },
+                    // Tier 4: Write Operations
+                    {
+                        name: 'itglue_update_organization',
+                        description: '✏️  Update an organization\'s details (name, description, quick notes, short name). AUDIT LOGGED.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                organization_id: { type: 'string', description: 'Organization ID to update' },
+                                name: { type: 'string', description: 'New organization name' },
+                                description: { type: 'string', description: 'Organization description' },
+                                quick_notes: { type: 'string', description: 'Quick notes (displayed prominently in ITGlue UI)' },
+                                short_name: { type: 'string', description: 'Short name / abbreviation' },
+                            },
+                            required: ['organization_id'],
+                        },
+                        annotations: {
+                            title: 'Update Organization',
+                            readOnlyHint: false,
+                            destructiveHint: true,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
+                    },
+                    {
+                        name: 'itglue_create_configuration',
+                        description: '➕ Create a new configuration (server, workstation, network device) for an organization. AUDIT LOGGED.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                organization_id: { type: 'string', description: 'Organization ID' },
+                                name: { type: 'string', description: 'Configuration name (hostname)' },
+                                configuration_type_id: { type: 'number', description: 'Configuration type ID' },
+                                configuration_status_id: { type: 'number', description: 'Configuration status ID' },
+                                serial_number: { type: 'string', description: 'Serial number' },
+                                asset_tag: { type: 'string', description: 'Asset tag' },
+                                manufacturer_name: { type: 'string', description: 'Manufacturer name' },
+                                model_number: { type: 'string', description: 'Model number' },
+                                notes: { type: 'string', description: 'Notes' },
+                            },
+                            required: ['organization_id', 'name', 'configuration_type_id'],
+                        },
+                        annotations: {
+                            title: 'Create Configuration',
+                            readOnlyHint: false,
+                            destructiveHint: false,
+                            idempotentHint: false,
+                            openWorldHint: true,
+                        },
+                    },
+                    {
+                        name: 'itglue_update_configuration',
+                        description: '✏️  Update an existing configuration\'s details. AUDIT LOGGED.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                configuration_id: { type: 'string', description: 'Configuration ID to update' },
+                                organization_id: { type: 'string', description: 'Organization ID (for audit)' },
+                                name: { type: 'string', description: 'New name' },
+                                configuration_type_id: { type: 'number', description: 'Configuration type ID' },
+                                configuration_status_id: { type: 'number', description: 'Configuration status ID' },
+                                serial_number: { type: 'string', description: 'Serial number' },
+                                asset_tag: { type: 'string', description: 'Asset tag' },
+                                manufacturer_name: { type: 'string', description: 'Manufacturer name' },
+                                model_number: { type: 'string', description: 'Model number' },
+                                notes: { type: 'string', description: 'Notes' },
+                            },
+                            required: ['configuration_id'],
+                        },
+                        annotations: {
+                            title: 'Update Configuration',
+                            readOnlyHint: false,
+                            destructiveHint: true,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
+                    },
+                    {
+                        name: 'itglue_create_password',
+                        description: '🔐 Create a new password entry for an organization. ⚠️  CRITICAL AUDIT LOGGED — password values are never stored in logs.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                organization_id: { type: 'string', description: 'Organization ID' },
+                                name: { type: 'string', description: 'Password name/label' },
+                                password: { type: 'string', description: 'The password value' },
+                                username: { type: 'string', description: 'Username' },
+                                url: { type: 'string', description: 'Service URL' },
+                                notes: { type: 'string', description: 'Notes' },
+                                password_category_id: { type: 'number', description: 'Password category ID' },
+                                resource_id: { type: 'number', description: 'Related resource ID' },
+                                resource_type: { type: 'string', description: 'Related resource type' },
+                            },
+                            required: ['organization_id', 'name', 'password'],
+                        },
+                        annotations: {
+                            title: 'Create Password',
+                            readOnlyHint: false,
+                            destructiveHint: false,
+                            idempotentHint: false,
+                            openWorldHint: true,
+                        },
+                    },
+                    {
+                        name: 'itglue_update_password',
+                        description: '🔐 Update an existing password entry (name, value, username, URL, category). ⚠️  CRITICAL AUDIT LOGGED.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                password_id: { type: 'string', description: 'Password ID to update' },
+                                organization_id: { type: 'string', description: 'Organization ID (for audit)' },
+                                name: { type: 'string', description: 'Password name/label' },
+                                password: { type: 'string', description: 'New password value' },
+                                username: { type: 'string', description: 'Username' },
+                                url: { type: 'string', description: 'Service URL' },
+                                notes: { type: 'string', description: 'Notes' },
+                                password_category_id: { type: 'number', description: 'Password category ID' },
+                            },
+                            required: ['password_id'],
+                        },
+                        annotations: {
+                            title: 'Update Password',
+                            readOnlyHint: false,
+                            destructiveHint: true,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
+                    },
+                    {
+                        name: 'itglue_create_contact',
+                        description: '👤 Create a new contact for an organization. AUDIT LOGGED.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                organization_id: { type: 'string', description: 'Organization ID' },
+                                first_name: { type: 'string', description: 'First name' },
+                                last_name: { type: 'string', description: 'Last name' },
+                                title: { type: 'string', description: 'Job title' },
+                                contact_type_id: { type: 'number', description: 'Contact type ID' },
+                                email: { type: 'string', description: 'Primary email' },
+                                phone: { type: 'string', description: 'Primary phone' },
+                                notes: { type: 'string', description: 'Notes' },
+                                important: { type: 'boolean', description: 'Mark as important/VIP', default: false },
+                            },
+                            required: ['organization_id', 'first_name', 'last_name'],
+                        },
+                        annotations: {
+                            title: 'Create Contact',
+                            readOnlyHint: false,
+                            destructiveHint: false,
+                            idempotentHint: false,
+                            openWorldHint: true,
+                        },
+                    },
+                    {
+                        name: 'itglue_update_contact',
+                        description: '✏️  Update an existing contact\'s details. AUDIT LOGGED.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                contact_id: { type: 'string', description: 'Contact ID to update' },
+                                organization_id: { type: 'string', description: 'Organization ID (for audit)' },
+                                first_name: { type: 'string', description: 'First name' },
+                                last_name: { type: 'string', description: 'Last name' },
+                                title: { type: 'string', description: 'Job title' },
+                                contact_type_id: { type: 'number', description: 'Contact type ID' },
+                                notes: { type: 'string', description: 'Notes' },
+                                important: { type: 'boolean', description: 'Mark as important/VIP' },
+                            },
+                            required: ['contact_id'],
+                        },
+                        annotations: {
+                            title: 'Update Contact',
+                            readOnlyHint: false,
+                            destructiveHint: true,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
+                    },
+                    {
+                        name: 'itglue_create_location',
+                        description: '📍 Create a new location (office, data center, site) for an organization. AUDIT LOGGED.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                organization_id: { type: 'string', description: 'Organization ID' },
+                                name: { type: 'string', description: 'Location name' },
+                                address1: { type: 'string', description: 'Street address line 1' },
+                                address2: { type: 'string', description: 'Street address line 2' },
+                                city: { type: 'string', description: 'City' },
+                                region_name: { type: 'string', description: 'State/region' },
+                                country_name: { type: 'string', description: 'Country' },
+                                postal_code: { type: 'string', description: 'ZIP/postal code' },
+                                phone: { type: 'string', description: 'Phone number' },
+                                notes: { type: 'string', description: 'Notes' },
+                                primary: { type: 'boolean', description: 'Set as primary location', default: false },
+                            },
+                            required: ['organization_id', 'name'],
+                        },
+                        annotations: {
+                            title: 'Create Location',
+                            readOnlyHint: false,
+                            destructiveHint: false,
+                            idempotentHint: false,
+                            openWorldHint: true,
+                        },
+                    },
+                    {
+                        name: 'itglue_update_location',
+                        description: '✏️  Update an existing location\'s details (address, phone, notes). AUDIT LOGGED.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                location_id: { type: 'string', description: 'Location ID to update' },
+                                organization_id: { type: 'string', description: 'Organization ID (for audit)' },
+                                name: { type: 'string', description: 'Location name' },
+                                address1: { type: 'string', description: 'Street address line 1' },
+                                address2: { type: 'string', description: 'Street address line 2' },
+                                city: { type: 'string', description: 'City' },
+                                region_name: { type: 'string', description: 'State/region' },
+                                country_name: { type: 'string', description: 'Country' },
+                                postal_code: { type: 'string', description: 'ZIP/postal code' },
+                                phone: { type: 'string', description: 'Phone number' },
+                                notes: { type: 'string', description: 'Notes' },
+                                primary: { type: 'boolean', description: 'Set as primary location' },
+                            },
+                            required: ['location_id'],
+                        },
+                        annotations: {
+                            title: 'Update Location',
+                            readOnlyHint: false,
+                            destructiveHint: true,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
+                    },
+                    {
+                        name: 'itglue_create_flexible_asset',
+                        description: '➕ Create a new flexible asset (custom documentation type) with trait values. AUDIT LOGGED.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                organization_id: { type: 'string', description: 'Organization ID' },
+                                flexible_asset_type_id: { type: 'number', description: 'Flexible asset type ID' },
+                                traits: {
+                                    type: 'object',
+                                    description: 'Custom field values as key-value pairs (use trait field names as keys)',
+                                    additionalProperties: true,
+                                },
+                            },
+                            required: ['organization_id', 'flexible_asset_type_id', 'traits'],
+                        },
+                        annotations: {
+                            title: 'Create Flexible Asset',
+                            readOnlyHint: false,
+                            destructiveHint: false,
+                            idempotentHint: false,
+                            openWorldHint: true,
+                        },
+                    },
+                    {
+                        name: 'itglue_update_flexible_asset',
+                        description: '✏️  Update a flexible asset\'s trait values. Only include traits to change. AUDIT LOGGED.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                flexible_asset_id: { type: 'string', description: 'Flexible asset ID to update' },
+                                organization_id: { type: 'string', description: 'Organization ID (for audit)' },
+                                traits: {
+                                    type: 'object',
+                                    description: 'Custom field values to update (only include fields to change)',
+                                    additionalProperties: true,
+                                },
+                            },
+                            required: ['flexible_asset_id', 'traits'],
+                        },
+                        annotations: {
+                            title: 'Update Flexible Asset',
+                            readOnlyHint: false,
+                            destructiveHint: true,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                     // Auxiliary Tools: Health Check
                     {
@@ -537,6 +967,13 @@ async function main() {
                                 },
                             },
                         },
+                        annotations: {
+                            title: 'Health Check',
+                            readOnlyHint: true,
+                            destructiveHint: false,
+                            idempotentHint: true,
+                            openWorldHint: true,
+                        },
                     },
                 ],
             };
@@ -562,6 +999,10 @@ async function main() {
                         const parsed = GlobalSearchSchema.parse(args);
                         return await globalSearch(client, parsed);
                     }
+                    case 'itglue_list_flexible_asset_types': {
+                        const parsed = ListFlexibleAssetTypesSchema.parse(args);
+                        return await listFlexibleAssetTypes(client, parsed);
+                    }
                     // Tier 2: Entity Navigation
                     case 'itglue_list_configurations': {
                         const parsed = ListConfigurationsSchema.parse(args);
@@ -608,6 +1049,51 @@ async function main() {
                         const parsed = GetFlexibleAssetSchema.parse(args);
                         return await getFlexibleAsset(client, parsed);
                     }
+                    // Tier 4: Write Operations
+                    case 'itglue_update_organization': {
+                        const parsed = UpdateOrganizationSchema.parse(args);
+                        return await updateOrganization(client, parsed);
+                    }
+                    case 'itglue_create_configuration': {
+                        const parsed = CreateConfigurationSchema.parse(args);
+                        return await createConfiguration(client, parsed);
+                    }
+                    case 'itglue_update_configuration': {
+                        const parsed = UpdateConfigurationSchema.parse(args);
+                        return await updateConfiguration(client, parsed);
+                    }
+                    case 'itglue_create_password': {
+                        const parsed = CreatePasswordSchema.parse(args);
+                        return await createPassword(client, parsed);
+                    }
+                    case 'itglue_update_password': {
+                        const parsed = UpdatePasswordSchema.parse(args);
+                        return await updatePassword(client, parsed);
+                    }
+                    case 'itglue_create_contact': {
+                        const parsed = CreateContactSchema.parse(args);
+                        return await createContact(client, parsed);
+                    }
+                    case 'itglue_update_contact': {
+                        const parsed = UpdateContactSchema.parse(args);
+                        return await updateContact(client, parsed);
+                    }
+                    case 'itglue_create_location': {
+                        const parsed = CreateLocationSchema.parse(args);
+                        return await createLocation(client, parsed);
+                    }
+                    case 'itglue_update_location': {
+                        const parsed = UpdateLocationSchema.parse(args);
+                        return await updateLocation(client, parsed);
+                    }
+                    case 'itglue_create_flexible_asset': {
+                        const parsed = CreateFlexibleAssetSchema.parse(args);
+                        return await createFlexibleAsset(client, parsed);
+                    }
+                    case 'itglue_update_flexible_asset': {
+                        const parsed = UpdateFlexibleAssetSchema.parse(args);
+                        return await updateFlexibleAsset(client, parsed);
+                    }
                     // Auxiliary Tools
                     case 'itglue_compliance_check': {
                         const parsed = ComplianceCheckSchema.parse(args);