Utility Tools

Additional utility and management tools for JCDS files, webhooks, LDAP integration, and system utilities.

File Management

Get JCDS Files

List all files stored in Jamf Cloud Distribution Service (JCDS).

Parameter

Type

Required

Description

No parameters required
Example Response
[
  {
    "id": "abc123def456",
    "name": "Company_Logo.png",
    "size": 45678,
    "md5": "d41d8cd98f00b204e9800998ecf8427e",
    "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "region": "us-east-1",
    "created": "2024-01-10T10:00:00Z",
    "modified": "2024-01-10T10:00:00Z"
  },
  {
    "id": "xyz789ghi012",
    "name": "Self_Service_Banner.jpg",
    "size": 123456,
    "md5": "5d41402abc4b2a76b9719d911017c592",
    "region": "us-east-1",
    "created": "2024-01-05T14:30:00Z"
  }
]

Usage Examples

List all files in JCDS
Show me all images stored in Jamf Cloud Distribution Service
Get all JCDS files with their sizes and checksums

Webhook Management

Get Webhooks

List all configured webhooks.

Parameter

Type

Required

Description

No parameters required
Example Response
[
  {
    "id": 1,
    "name": "Slack Notifications",
    "enabled": true,
    "url": "https://hooks.slack.com/services/...",
    "content_type": "application/json",
    "event": "ComputerAdded",
    "connection_timeout": 5000,
    "read_timeout": 5000
  },
  {
    "id": 2,
    "name": "ServiceNow Integration",
    "enabled": true,
    "url": "https://instance.service-now.com/api/...",
    "event": "ComputerCheckIn",
    "authentication_type": "Basic",
    "username": "jamf_integration"
  }
]

Usage Examples

List all webhooks
Show me all enabled webhooks
Get webhooks configured for Slack notifications

Related Tools

Get Webhook Details

Detailed webhook configuration

Get Webhook Details
Get Policies

Webhook triggers from policies

Get Policies

Get Webhook Details

Get detailed information about a specific webhook.

Parameter

Type

Required

Description

webhook_id

str | int

Yes

Webhook ID
Example Response
{
  "id": 1,
  "name": "Slack Notifications",
  "enabled": true,
  "url": "https://hooks.slack.com/services/...",
  "content_type": "application/json",
  "event": "ComputerAdded",
  "connection_timeout": 5000,
  "read_timeout": 5000,
  "authentication_type": "None",
  "username": "",
  "enable_display_fields_for_group_object": false,
  "smart_group": {
    "id": -1,
    "name": "None"
  },
  "display_fields": [
    {
      "name": "general",
      "inventory_display": {
        "id": "general"
      }
    },
    {
      "name": "hardware",
      "inventory_display": {
        "id": "hardware"
      }
    }
  ]
}

Usage Examples

Get details for webhook ID 1
Show me the configuration for webhook 5
What events trigger webhook ID 10?

Related Tools

Get Webhooks

List all webhooks

Get Webhooks
Get Smart Groups

Groups used in webhooks

Get Smart Groups

Directory Services

Get LDAP Servers

List all configured LDAP servers.

Parameter

Type

Required

Description

No parameters required
Example Response
[
  {
    "id": 1,
    "name": "Corporate Active Directory",
    "hostname": "ldap.company.com",
    "port": 389,
    "use_ssl": true,
    "authentication_type": "Simple",
    "account": "CN=JamfLDAP,OU=ServiceAccounts,DC=company,DC=com",
    "use_wildcards": true,
    "connection_timeout": 15,
    "search_timeout": 60,
    "referral_response": "Follow"
  },
  {
    "id": 2,
    "name": "Azure AD",
    "hostname": "ldaps.company.com",
    "port": 636,
    "use_ssl": true
  }
]

Usage Examples

List all LDAP servers
Show me Active Directory configurations
Get all LDAP servers using SSL

Related Tools

Get LDAP Server Details

Detailed LDAP configuration

Get LDAP Server Details
Get Users

LDAP-synced users

Get Users

Get LDAP Server Details

Get detailed information about a specific LDAP server.

Parameter

Type

Required

Description

server_id

str | int

Yes

LDAP server ID
Example Response
{
  "id": 1,
  "name": "Corporate Active Directory",
  "hostname": "ldap.company.com",
  "port": 389,
  "use_ssl": true,
  "authentication_type": "Simple",
  "account": "CN=JamfLDAP,OU=ServiceAccounts,DC=company,DC=com",
  "use_wildcards": true,
  "connection_timeout": 15,
  "search_timeout": 60,
  "referral_response": "Follow",
  "mappings": {
    "user_mappings": {
      "user_id": "sAMAccountName",
      "username": "sAMAccountName",
      "real_name": "displayName",
      "email_address": "mail",
      "department": "department",
      "building": "physicalDeliveryOfficeName",
      "room": "roomNumber",
      "telephone": "telephoneNumber",
      "position": "title"
    },
    "user_group_mappings": {
      "object_classes": "group",
      "search_base": "DC=company,DC=com",
      "search_scope": "All Subtrees",
      "group_id": "cn",
      "group_name": "cn"
    }
  },
  "connection": {
    "open_close_timeout": 15,
    "search_timeout": 60,
    "use_referrals": true,
    "test_successful": true,
    "test_date": "2024-01-15T10:00:00Z"
  }
}

Usage Examples

Get details for LDAP server ID 1
Show me the user mappings for LDAP server 2
Check if LDAP server 1 connection test was successful

Related Tools

Get LDAP Servers

List all LDAP servers

Get LDAP Servers
Get Directory Bindings

Directory binding configurations

Get Directory Bindings

Get Directory Bindings

List all directory binding configurations.

Parameter

Type

Required

Description

No parameters required
Example Response
[
  {
    "id": 1,
    "name": "Active Directory Binding",
    "priority": 1,
    "domain": "COMPANY.COM",
    "username": "jamfbind",
    "computer_ou": "CN=Computers,DC=company,DC=com",
    "type": "Active Directory"
  },
  {
    "id": 2,
    "name": "OpenDirectory Binding",
    "priority": 2,
    "server": "od.company.com",
    "type": "Open Directory"
  }
]

Usage Examples

List all directory bindings
Show me Active Directory bindings
Get directory binding priorities

Related Tools

Get Directory Binding Details

Detailed binding configuration

Get Directory Binding Details
Get LDAP Servers

LDAP server configurations

Get LDAP Servers

Get Directory Binding Details

Get detailed information about a specific directory binding.

Parameter

Type

Required

Description

binding_id

str | int

Yes

Directory binding ID
Example Response
{
  "id": 1,
  "name": "Active Directory Binding",
  "priority": 1,
  "domain": "COMPANY.COM",
  "username": "jamfbind",
  "computer_ou": "CN=Computers,DC=company,DC=com",
  "type": "Active Directory",
  "open_close_timeout": 15,
  "mapping": {
    "uid": "sAMAccountName",
    "user_gid": "primaryGroupID",
    "gid": "primaryGroupID",
    "preferred_domain_controller": "",
    "preferred_domain_controller_port": 389
  },
  "cache": {
    "cache_last_user": true,
    "require_confirmation": false,
    "local_home": false,
    "use_unc_path": true,
    "mount_style": "SMB",
    "default_shell": "/bin/bash"
  },
  "administrative": {
    "preferred_domain_controller": "",
    "allowed_groups": "Domain Admins,Enterprise Admins",
    "authentication_from_any_domain": true,
    "packet_signing": "Allow",
    "packet_encryption": "Allow",
    "password_interval": 14,
    "restrict_ddns": false,
    "namespace": "Domain"
  }
}

Usage Examples

Get details for directory binding ID 1
Show me the cache settings for binding 2
What is the computer OU for Active Directory binding?

Related Tools

Get Directory Bindings

List all bindings

Get Directory Bindings
Get LDAP Server Details

LDAP server details

Get LDAP Server Details

Computer Groups

Get Smart Groups

List all smart computer groups.

Parameter

Type

Required

Description

No parameters required
Example Response
[
  {
    "id": 1,
    "name": "All Managed Computers",
    "is_smart": true,
    "criteria": [
      {
        "name": "Managed",
        "priority": 0,
        "and_or": "and",
        "search_type": "is",
        "value": "Managed"
      }
    ],
    "site": {
      "id": -1,
      "name": "None"
    }
  },
  {
    "id": 2,
    "name": "macOS 14 Computers",
    "is_smart": true,
    "criteria": [
      {
        "name": "Operating System Version",
        "priority": 0,
        "and_or": "and",
        "search_type": "like",
        "value": "14."
      }
    ]
  }
]

Usage Examples

List all smart computer groups
Show me groups based on OS version
Get all smart groups with their criteria

Related Tools

Get Group Details

Group members and details

Get Smart Group Details
Get Policies

Policies scoped to groups

Get Policies

Get Smart Group Details

Get detailed information about a computer group.

Parameter

Type

Required

Description

group_id

str

Yes

Computer group ID
Example Response
{
  "id": 1,
  "name": "All Managed Computers",
  "is_smart": true,
  "criteria": [
    {
      "name": "Managed",
      "priority": 0,
      "and_or": "and",
      "search_type": "is",
      "value": "Managed",
      "opening_paren": false,
      "closing_paren": false
    }
  ],
  "site": {
    "id": -1,
    "name": "None"
  },
  "computers": [
    {
      "id": 123,
      "name": "John-MacBook-Pro",
      "serial_number": "ABC123456",
      "mac_address": "00:11:22:33:44:55"
    }
  ],
  "computer_count": 245
}

Usage Examples

Get details for smart group ID 1
Show me all computers in group 5
How many computers are in the macOS 14 group?

Related Tools

Get Smart Groups

List all smart groups

Get Smart Groups
Get Computer Inventory

Computer group memberships

Get Computer Inventory

Get Extension Attributes

List all computer extension attributes.

Parameter

Type

Required

Description

No parameters required
Example Response
[
  {
    "id": 1,
    "name": "Battery Cycle Count",
    "enabled": true,
    "description": "Returns the battery cycle count",
    "data_type": "Integer",
    "input_type": "Script",
    "inventory_display": "Hardware"
  },
  {
    "id": 2,
    "name": "Time Machine Status",
    "enabled": true,
    "description": "Checks if Time Machine is configured",
    "data_type": "String",
    "input_type": "Script",
    "inventory_display": "Operating System"
  }
]

Usage Examples

List all extension attributes
Show me enabled extension attributes
Get all script-based extension attributes

Related Tools

Get Computer Inventory

Extension attribute values

Get Computer Inventory
Get Scripts

Scripts used in attributes

Get Scripts

System Utilities

Ping

Simple ping test to verify MCP server connectivity.

Parameter

Type

Required

Description

No parameters required
Example Response
{
  "message": "pong",
  "status": "ok"
}

Usage Examples

Ping the MCP server
Test server connectivity
Verify the MCP server is responding

Related Tools

Get Health Scorecard

Full system health check

Get Health Scorecard
Get Computer Inventory

Verify data retrieval

Get Computer Inventory

Best Practices

Webhook Security

  1. Use HTTPS: Always use HTTPS endpoints

  2. Authentication: Configure authentication

  3. Timeout Settings: Set appropriate timeouts

  4. Error Handling: Monitor webhook failures

  5. Payload Size: Be aware of size limits

LDAP Configuration

  1. Use SSL/TLS: Always encrypt LDAP traffic

  2. Service Accounts: Use dedicated accounts

  3. Search Optimization: Configure search bases

  4. Connection Testing: Regularly test connections

  5. Timeout Values: Set reasonable timeouts

Advanced Searches

  1. Performance: Avoid overly complex criteria

  2. Naming Convention: Use descriptive names

  3. Regular Review: Audit saved searches

  4. Display Fields: Only include needed fields

  5. Site Scoping: Use sites to limit scope

Extension Attributes

  1. Script Efficiency: Optimize script performance

  2. Error Handling: Handle script failures gracefully

  3. Data Types: Use appropriate data types

  4. Documentation: Document attribute purpose

  5. Regular Audits: Review for unused attributes

See also