TeamDynamix MCP
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.
Explore
- 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
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 MCPCommand (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
From the repository
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.
pnpm install
cp .env.example .env
TEAMDYNAMIX_BASE_URL=https://your-tenant.teamdynamix.com/TDWebApi
TEAMDYNAMIX_AUTH_MODE=standard # or: admin
[email protected] # standard mode
TEAMDYNAMIX_PASSWORD=your-password # standard mode
For admin mode, use TEAMDYNAMIX_BEID and TEAMDYNAMIX_WEB_SERVICES_KEY instead.
> Security notice: Values shown above are placeholders. Never commit real credentials to source control.
> Inject secrets at runtime via a .env file (excluded by .gitignore), CI/CD secrets, or a secret manager.
{
"mcpServers": {
"teamdynamix": {
"command": "npx",
"args": ["-y", "@selfagency/teamdynamix-mcp"],
"env": {
"TEAMDYNAMIX_BASE_URL": "https://your-tenant.teamdynamix.com/TDWebApi",
"TEAMDYNAMIX_AUTH_MODE": "standard",
"TEAMDYNAMIX_USERNAME": "[email protected]",
"TEAMDYNAMIX_PASSWORD": "your-password"
}
}
}
}
```
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.
Each gateway tool accepts:
- action: domain-specific operation name
- payload: object for that action’s parameters
- response_format: "markdown" or "json"
| Domain | Gateway tool |
| -------------------- | ---------------------------------- |
| Discovery | teamdynamix_discovery |
| Tickets | teamdynamix_tickets |
| Ticket relationships | teamdynamix_ticket_relationships |
| Knowledge Base | teamdynamix_knowledge_base |
| Assets | teamdynamix_assets |
| CMDB | teamdynamix_cmdb |
| People | teamdynamix_people |
| Services | teamdynamix_services |
| Projects | teamdynamix_projects |
| Time | teamdynamix_time |
| Reference data | teamdynamix_reference_data |
† Requires confirm: true in addition to write tools being enabled.
All write/mutating actions require TEAMDYNAMIX_ENABLE_WRITE_TOOLS=true.
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"
}
}
}
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
