@selfagency/teamdynamix-mcp 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -3
- package/index.js +500 -421
- package/index.js.map +1 -1
- package/package.json +7 -3
package/README.md
CHANGED
|
@@ -1,20 +1,32 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 🎟️ TeamDynamix MCP Server (unofficial)
|
|
2
|
+
|
|
3
|
+
 [](https://github.com/selfagency/teamdynamix-mcp/actions/workflows/ci.yml) [](https://codecov.io/gh/selfagency/teamdynamix-mcp)
|
|
2
4
|
|
|
3
5
|
A TypeScript [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that exposes [TeamDynamix](https://www.teamdynamix.com/) ITSM capabilities as agent-callable tools. Designed for AI agents and MCP clients that need structured, safety-gated access to TeamDynamix operations.
|
|
4
6
|
|
|
5
7
|
## Features
|
|
6
8
|
|
|
9
|
+
- **Powered by the official TeamDynamix TypeScript SDK**: type-safe, auto-generated API methods with built-in retry, exponential backoff, runtime validation, and token lifecycle management
|
|
7
10
|
- **11 domain gateway tools** that route validated actions across discovery,
|
|
8
11
|
tickets, relationships, KB, assets, CMDB, people, services, projects,
|
|
9
12
|
time, and reference data
|
|
10
13
|
- **Safe by default**: write tools disabled until explicitly opted in;
|
|
11
14
|
destructive operations require `confirm: true`
|
|
12
15
|
- **Two auth modes**: standard (username/password) and admin (BEID/WebServicesKey)
|
|
13
|
-
- **
|
|
16
|
+
- **Covers 207 API endpoints** across all TeamDynamix domains, verified against the SDK route manifest
|
|
17
|
+
- **Rate-limit aware**: SDK built-in retry with exponential backoff on 429 and 5xx responses
|
|
14
18
|
- **Zod-validated inputs**: schema enforcement before any API call
|
|
15
19
|
- **Agent skill and prompt included**: ready-to-use skill definition for
|
|
16
20
|
GitHub Copilot and compatible agents
|
|
17
21
|
|
|
22
|
+
## MCP Registry
|
|
23
|
+
|
|
24
|
+
This server is published to the [MCP Registry](https://modelcontextprotocol.io/) as `io.github.selfagency/teamdynamix-mcp`.
|
|
25
|
+
|
|
26
|
+
- **Registry name**: `io.github.selfagency/teamdynamix-mcp`
|
|
27
|
+
- **Install via registry**: `mcp-install io.github.selfagency/teamdynamix-mcp` (when available)
|
|
28
|
+
- **Manual install**: Use npm package `@selfagency/teamdynamix-mcp` as shown below
|
|
29
|
+
|
|
18
30
|
## Quick start (developer setup)
|
|
19
31
|
|
|
20
32
|
This quick start is for contributors running the server from source in this
|
|
@@ -51,6 +63,9 @@ For admin mode, use `TEAMDYNAMIX_BEID` and `TEAMDYNAMIX_WEB_SERVICES_KEY` instea
|
|
|
51
63
|
|
|
52
64
|
## MCP client configuration
|
|
53
65
|
|
|
66
|
+
> **Security notice:** Values shown above are placeholders. **Never commit real credentials to source control.**
|
|
67
|
+
> Inject secrets at runtime via a `.env` file (excluded by `.gitignore`), CI/CD secrets, or a secret manager.
|
|
68
|
+
|
|
54
69
|
### VS Code (`.vscode/mcp.json`)
|
|
55
70
|
|
|
56
71
|
```json
|
|
@@ -184,4 +199,4 @@ pnpm build # tsup → dist/
|
|
|
184
199
|
|
|
185
200
|
## License
|
|
186
201
|
|
|
187
|
-
MIT © [
|
|
202
|
+
MIT © [The Self Agency LLC](https://self.agency)
|