TeamDynamix MCP

by selfagency

1 stars

265 downloads

Not rated

GitHub Website

Other

About

An unofficial TypeScript Model Context Protocol (MCP) server that exposes TeamDynamix ITSM capabilities as agent-callable tools. It provides structured, safety-gated access to TeamDynamix operations for AI agents and MCP clients.

Details

Author: selfagency
GitHub stars: 1
Downloads: 265
Categories: Other

- 11 domain gateway tools covering tickets, assets, KB, CMDB, and more
- Safe by default: write, delete, and admin tools disabled until opted in
- Two authentication modes: standard (username/password) and admin (BEID/WebServicesKey)
- Covers 207 API endpoints across all TeamDynamix domains
- Rate-limit aware with built-in retry and exponential backoff
- Zod-validated inputs enforce schema before any API call

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name TeamDynamix MCP

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

From the repository

Install via npm (npx -y @selfagency/teamdynamix-mcp) and configure with environment variables: TEAMDYNAMIX_BASE_URL, TEAMDYNAMIX_AUTH_MODE (standard or admin), and credentials. Then call domain gateway tools (e.g., teamdynamix_discovery, teamdynamix_tickets) with an action, payload, and response format ("markdown" or "json").

`teamdynamix_discovery`

Gateway for discovery operations: server status, current user, applications, and ticket status lookup.

`teamdynamix_tickets`

Gateway for ticket metadata, read/search, create/update, comments, and feed operations.

`teamdynamix_ticket_relationships`

Gateway for ticket tasks, linked assets, and linked contacts operations.

`teamdynamix_people`

Gateway for user and group retrieval/search operations.

`teamdynamix_knowledge_base`

Gateway for TeamDynamix Knowledge Base retrieval, search, and write operations.

`teamdynamix_assets`

Gateway for TeamDynamix asset retrieval, search, and lookup enumerations.

`teamdynamix_cmdb`

Gateway for CI/CMDB retrieval, search, types, relationship types, and vendors.

`teamdynamix_services`

Gateway for TeamDynamix service catalog list/get/search/category operations.

`teamdynamix_projects`

Gateway for TeamDynamix projects retrieval/search and project issue/risk operations.

`teamdynamix_time`

Gateway for TeamDynamix time type lookup and authenticated user time entries.

`teamdynamix_reference_data`

Gateway for TeamDynamix reference/enumeration lookups such as accounts, locations, roles, and custom attributes.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "teamdynamix mcp": {
            "git": {
                "command": "npx",
                "args": [
                    "-y",
                    "@selfagency/teamdynamix-mcp"
                ],
                "env": {
                    "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
                    "TEAMDYNAMIX_AUTH_MODE": "standard",
                    "TEAMDYNAMIX_USERNAME": "your-username",
                    "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
                }
            }
        }
    }
}

McpServers

{
    "git": {
        "command": "npx",
        "args": [
            "-y",
            "@selfagency/teamdynamix-mcp"
        ],
        "env": {
            "TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com",
            "TEAMDYNAMIX_AUTH_MODE": "standard",
            "TEAMDYNAMIX_USERNAME": "your-username",
            "TEAMDYNAMIX_PASSWORD": "your-password-preferably-stored-securely"
        }
    }
}

🎟️ TeamDynamix MCP Server (unofficial)

NPM Version

A TypeScript Model Context Protocol (MCP) server that exposes TeamDynamix ITSM capabilities as agent-callable tools. Designed for AI agents and MCP clients that need structured, safety-gated access to TeamDynamix operations.

Features

- 11 domain gateway tools that route validated actions across discovery,
tickets, relationships, KB, assets, CMDB, people, services, projects,
time, and reference data
- Safe by default: write, delete, and admin tools disabled until
explicitly opted in; destructive operations require confirm: true
- Two auth modes: standard (username/password) and admin (BEID/WebServicesKey)
- Covers 207 API endpoints across all TeamDynamix domains, verified against the SDK route manifest
- Rate-limit aware: SDK built-in retry with exponential backoff on 429 and 5xx responses
- Zod-validated inputs: schema enforcement before any API call
- Agent skill and prompt included: ready-to-use skill definition for
GitHub Copilot and compatible agents

MCP Registry

This server is published to the MCP Registry as io.github.selfagency/teamdynamix-mcp.

- Registry name: io.github.selfagency/teamdynamix-mcp
- Install via registry: mcp-install io.github.selfagency/teamdynamix-mcp (when available)
- Manual install: Use npm package @selfagency/teamdynamix-mcp as shown below

Quick start (developer setup)

This quick start is for contributors running the server from source in this
repository. If you are a regular MCP client user, skip to
MCP client configuration and use the npx
command examples.

```sh

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

teamdynamix_discovery

teamdynamix_tickets

teamdynamix_ticket_relationships

teamdynamix_people

teamdynamix_knowledge_base

teamdynamix_assets

teamdynamix_cmdb

teamdynamix_services

teamdynamix_projects

teamdynamix_time

teamdynamix_reference_data

Claude Desktop / Cursor

McpServers

🎟️ TeamDynamix MCP Server (unofficial)

Features

MCP Registry

Quick start (developer setup)

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`teamdynamix_discovery`

`teamdynamix_tickets`

`teamdynamix_ticket_relationships`

`teamdynamix_people`

`teamdynamix_knowledge_base`

`teamdynamix_assets`

`teamdynamix_cmdb`

`teamdynamix_services`

`teamdynamix_projects`

`teamdynamix_time`

`teamdynamix_reference_data`