@tellagen/mcp-server 0.1.0 → 0.1.3

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 CHANGED
@@ -21,7 +21,7 @@ In Tellagen, go to **Settings > API Keys** and create a key with both `incidents
21
21
  "mcpServers": {
22
22
  "tellagen": {
23
23
  "command": "npx",
24
- "args": ["@tellagen/mcp-server"],
24
+ "args": ["-y", "@tellagen/mcp-server"],
25
25
  "env": {
26
26
  "TELLAGEN_API_KEY": "tllg_...",
27
27
  "TELLAGEN_API_URL": "https://yourcompany.api.tellagen.com"
@@ -38,7 +38,7 @@ In Tellagen, go to **Settings > API Keys** and create a key with both `incidents
38
38
  "mcpServers": {
39
39
  "tellagen": {
40
40
  "command": "npx",
41
- "args": ["@tellagen/mcp-server"],
41
+ "args": ["-y", "@tellagen/mcp-server"],
42
42
  "env": {
43
43
  "TELLAGEN_API_KEY": "tllg_...",
44
44
  "TELLAGEN_API_URL": "https://yourcompany.api.tellagen.com"
@@ -50,7 +50,9 @@ In Tellagen, go to **Settings > API Keys** and create a key with both `incidents
50
50
 
51
51
  ### 3. Investigate
52
52
 
53
- Ask your AI agent: *"Investigate incident #42 on Tellagen"*
53
+ From a Tellagen incident, click **Investigate with AI**, then copy the Codex or Claude command. The command includes an `investigation_run_id`; your local agent should call `tellagen_pick_up_investigation` with that ID before doing any evidence work.
54
+
55
+ If you are starting outside the Tellagen UI, ask your AI agent: *"Start a local Tellagen investigation for incident #42"*.
54
56
 
55
57
  ## Tools
56
58
 
@@ -62,18 +64,37 @@ Ask your AI agent: *"Investigate incident #42 on Tellagen"*
62
64
  | `tellagen_list_incidents` | List all incidents, optionally filtered by status |
63
65
  | `tellagen_get_incident_timeline` | Get the timeline of events for an incident |
64
66
  | `tellagen_list_investigation_runs` | List investigation runs for an incident |
67
+ | `tellagen_get_incident_context` | Get the full context bundle for an existing investigation run |
68
+ | `tellagen_list_trace_steps` | List progress trace steps already posted for an investigation run |
69
+ | `tellagen_list_runbooks` | List matched runbooks/skills for a run |
70
+ | `tellagen_get_investigation_workspace` | Get the investigation workspace for an incident |
65
71
  | `tellagen_list_findings` | List findings for an incident, optionally filtered by run |
66
72
  | `tellagen_get_finding` | Get a single finding with full details |
73
+ | `tellagen_get_timeline_event` | Get one timeline event |
74
+ | `tellagen_list_timeline_comments` | List comments on a timeline event |
75
+ | `tellagen_get_impact_summary` | Get the current impact summary for an incident |
76
+ | `tellagen_list_affected_customers` | List affected customers for an incident |
77
+ | `tellagen_search` | Search Tellagen incidents, findings, timeline entries, and related records |
78
+ | `tellagen_list_services` | List services configured in Tellagen |
79
+ | `tellagen_get_service` | Get one service and its metadata |
67
80
 
68
81
  ### Write tools
69
82
 
70
83
  | Tool | Description |
71
84
  |------|-------------|
72
- | `tellagen_start_investigation` | Start a new investigation run on an incident |
85
+ | `tellagen_create_incident` | Create an incident; use `short_title` for the concise incident title (`gist` remains accepted as a legacy alias) |
86
+ | `tellagen_update_incident` | Update incident metadata, status, impact summary, links, or timestamps |
87
+ | `tellagen_start_investigation` | Start a local investigation run when no UI-created run ID was provided |
88
+ | `tellagen_pick_up_investigation` | Attach the local agent to a UI-created awaiting run |
89
+ | `tellagen_post_trace_step` | Post live investigation progress steps |
90
+ | `tellagen_update_investigation_scope` | Update the investigation scope as evidence changes |
73
91
  | `tellagen_post_finding` | Post a structured finding to an active investigation |
74
- | `tellagen_complete_investigation` | Mark an investigation as completed or failed |
92
+ | `tellagen_complete_investigation` | Mark an investigation as completed or failed, with RCA summary support |
75
93
  | `tellagen_update_finding` | Update a finding's status (dismiss or restore) |
76
94
  | `tellagen_promote_finding` | Promote a finding to the incident timeline |
95
+ | `tellagen_post_timeline_event` | Add a timeline event directly |
96
+ | `tellagen_update_timeline_event` | Update a timeline event |
97
+ | `tellagen_add_timeline_comment` | Comment on a timeline event |
77
98
 
78
99
  ## Composing with other MCP servers
79
100
 
@@ -84,7 +105,7 @@ The Tellagen MCP server is designed to work alongside vendor MCP servers for obs
84
105
  "mcpServers": {
85
106
  "tellagen": {
86
107
  "command": "npx",
87
- "args": ["@tellagen/mcp-server"],
108
+ "args": ["-y", "@tellagen/mcp-server"],
88
109
  "env": {
89
110
  "TELLAGEN_API_KEY": "tllg_...",
90
111
  "TELLAGEN_API_URL": "https://yourcompany.api.tellagen.com"
@@ -111,11 +132,13 @@ The Tellagen MCP server is designed to work alongside vendor MCP servers for obs
111
132
 
112
133
  The agent uses Tellagen tools to manage the investigation lifecycle and vendor tools to gather evidence:
113
134
 
114
- 1. **Read** the incident from Tellagen
115
- 2. **Query** Grafana Loki for error logs, Prometheus for metrics
116
- 3. **Check** GitHub for recent deploys and code changes
117
- 4. **Post** findings back to Tellagen as they're discovered
118
- 5. **Complete** the investigation run
135
+ 1. **Pick up** the Tellagen run if the UI command included `investigation_run_id`
136
+ 2. **Read** the returned context bundle, including runbooks and investigation scope
137
+ 3. **Post trace steps** before and after meaningful checks
138
+ 4. **Query** Grafana Loki for error logs, Prometheus for metrics
139
+ 5. **Check** GitHub for recent deploys and code changes
140
+ 6. **Post** findings back to Tellagen as they're discovered
141
+ 7. **Complete** the investigation run with a concise RCA summary
119
142
 
120
143
  ## Authentication
121
144
 
@@ -131,7 +154,7 @@ The API key needs both scopes:
131
154
  | Scope | Required for |
132
155
  |-------|-------------|
133
156
  | `incidents:read` | Reading incidents, timelines, investigation runs, findings |
134
- | `incidents:write` | Starting investigations, posting findings, promoting to timeline |
157
+ | `incidents:write` | Creating/updating incidents, starting investigations, posting traces/findings/timeline events, promoting to timeline |
135
158
 
136
159
  ## Development
137
160
 
package/SKILL.md CHANGED
@@ -6,7 +6,7 @@ You have access to the Tellagen MCP server. This guide teaches you how to use it
6
6
 
7
7
  Tellagen is an incident investigation platform. Your role is to act as an on-call AI investigator: read incidents, gather evidence from observability and source control systems, post structured findings, and promote key findings to the incident timeline so human responders see them in the war room.
8
8
 
9
- ## Tools available (12 total)
9
+ ## Tools available (30 total)
10
10
 
11
11
  ### Incidents
12
12
  | Tool | Method | What it does |
@@ -14,14 +14,22 @@ Tellagen is an incident investigation platform. Your role is to act as an on-cal
14
14
  | `tellagen_get_incident` | GET | Read incident details — severity, status, services, timestamps, manager |
15
15
  | `tellagen_list_incidents` | GET | List incidents, optionally filter by `active` / `resolved` / `all` |
16
16
  | `tellagen_get_incident_timeline` | GET | Read the incident timeline — status changes, decisions, promoted findings |
17
- | `tellagen_create_incident` | POST | Declare a new incident (all fields optional: service, severity, regions, gist, team_id, etc.) |
17
+ | `tellagen_create_incident` | POST | Declare a new incident (all fields optional: service, severity, regions, short_title, team_id, etc.; `gist` is accepted as a legacy alias) |
18
+ | `tellagen_update_incident` | PATCH | Update incident metadata, status, timestamps, impact summary, links, service, severity, or regions |
18
19
 
19
20
  ### Investigations
20
21
  | Tool | Method | What it does |
21
22
  |------|--------|-------------|
22
- | `tellagen_start_investigation` | POST | Open an investigation run — returns a `run_id` you must use for all findings |
23
+ | `tellagen_start_investigation` | POST | Open a local investigation run only when the UI did not provide a run ID |
24
+ | `tellagen_get_incident_context` | GET | Read the full context bundle for a run: incident, timeline, scope, connectors, runbooks, prior findings, output schema |
25
+ | `tellagen_pick_up_investigation` | POST | Attach this local agent to a UI-created run and move it from `awaiting_agent` to `running` |
26
+ | `tellagen_post_trace_step` | POST | Write live progress steps so responders can watch what you checked |
27
+ | `tellagen_list_trace_steps` | GET | Read prior trace steps for a run before resuming work or completing the investigation |
28
+ | `tellagen_list_runbooks` | GET | List matched runbooks/skills for a run; guidance only, not executable code |
23
29
  | `tellagen_list_investigation_runs` | GET | List runs for an incident (shows status, agent info, finding counts) |
24
- | `tellagen_complete_investigation` | PATCH | Close a run as `completed` or `failed` (with `failure_reason`) |
30
+ | `tellagen_get_investigation_workspace` | GET | Read the incident investigation workspace: current scope, runs, findings, and related work context |
31
+ | `tellagen_update_investigation_scope` | PATCH | Refine investigation scope as evidence narrows or broadens the suspected blast radius |
32
+ | `tellagen_complete_investigation` | PATCH | Close a run as `completed` or `failed` and include an RCA `result_summary` when possible |
25
33
 
26
34
  ### Findings
27
35
  | Tool | Method | What it does |
@@ -32,23 +40,48 @@ Tellagen is an incident investigation platform. Your role is to act as an on-cal
32
40
  | `tellagen_update_finding` | PATCH | Dismiss or restore a finding |
33
41
  | `tellagen_promote_finding` | POST | Promote a finding to the incident timeline (creates a visible timeline event) |
34
42
 
43
+ ### Timeline
44
+ | Tool | Method | What it does |
45
+ |------|--------|-------------|
46
+ | `tellagen_post_timeline_event` | POST | Add a timestamped incident fact, decision, mitigation, recovery marker, or evidence-backed event |
47
+ | `tellagen_get_timeline_event` | GET | Read one timeline event, including attached evidence and AI context |
48
+ | `tellagen_update_timeline_event` | PATCH | Correct or enrich a timeline event as better evidence arrives |
49
+ | `tellagen_add_timeline_comment` | POST | Add a comment to a timeline event for responder context or follow-up |
50
+ | `tellagen_list_timeline_comments` | GET | Read comments on a timeline event |
51
+
52
+ ### Context and reference data
53
+ | Tool | Method | What it does |
54
+ |------|--------|-------------|
55
+ | `tellagen_get_impact_summary` | GET | Read the current customer/business impact summary for an incident |
56
+ | `tellagen_list_affected_customers` | GET | List affected customers for an incident, optionally filtered by status or email |
57
+ | `tellagen_search` | GET | Search Tellagen incidents, timeline entries, findings, and related records |
58
+ | `tellagen_list_services` | GET | List configured services so agents use canonical service identifiers |
59
+ | `tellagen_get_service` | GET | Read one service and its metadata |
60
+
35
61
  ## Investigation lifecycle
36
62
 
37
63
  Every investigation follows this sequence. Do not skip steps.
38
64
 
39
65
  ```
40
- 1. tellagen_get_incident → understand what happened
41
- 2. tellagen_start_investigation → open a run, get run_id
42
- 3. [gather evidence] → use Grafana, GitHub, codebase, PagerDuty, etc.
43
- 4. tellagen_post_finding → post each finding as you discover it (do NOT batch)
44
- 5. tellagen_promote_finding → promote key findings to the timeline
45
- 6. tellagen_complete_investigation → close the run
66
+ 1. tellagen_pick_up_investigation → if the prompt includes investigation_run_id, attach to that run first
67
+ 2. tellagen_start_investigation → only if no run ID was provided; then pick up the created run
68
+ 3. tellagen_get_incident_context → read incident scope, prior findings, connectors, runbooks, and output expectations
69
+ 4. tellagen_list_trace_steps → if resuming, read what the agent already checked
70
+ 5. tellagen_get_impact_summary → check customer/business impact when available
71
+ 6. tellagen_post_trace_step → post readable progress before/after meaningful checks
72
+ 7. [gather evidence] → use Grafana, GitHub, codebase, PagerDuty, kubectl, etc.
73
+ 8. tellagen_post_finding → post each finding as you discover it (do NOT batch)
74
+ 9. tellagen_promote_finding → promote key findings to the timeline
75
+ 10. tellagen_post_timeline_event → add timestamped facts, decisions, mitigations, and recovery markers when needed
76
+ 11. tellagen_complete_investigation → close the run with an RCA result_summary
46
77
  ```
47
78
 
48
79
  ### Rules
80
+ - **Pick up the current run when one is provided.** If the user pasted a Tellagen command with `investigation_run_id`, do not call `tellagen_start_investigation`.
49
81
  - **Post findings incrementally.** Every meaningful observation, correlation, or hypothesis gets its own finding posted immediately. Do not wait until the end.
50
82
  - **One run per investigation session.** Start one run, post all findings to it, then complete it.
51
83
  - **Always complete the run.** Even if you hit errors, call `tellagen_complete_investigation` with `status: "failed"` and a `failure_reason`.
84
+ - **Use runbooks as guidance.** Runbooks/skills are RCA instructions and checklists, not executable code.
52
85
 
53
86
  ## Posting findings
54
87
 
@@ -271,7 +304,7 @@ When you detect something wrong (e.g., while monitoring dashboards), you can dec
271
304
  tellagen_create_incident(
272
305
  service="payments",
273
306
  severity="sev2",
274
- gist="5xx-spike",
307
+ short_title="5xx-spike",
275
308
  regions=["us-east-1"],
276
309
  create_slack_channel=true
277
310
  )
package/dist/server.js CHANGED
@@ -5,9 +5,9 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
5
5
  import { registerAllTools } from "./tools/index.js";
6
6
  const INSTRUCTIONS = `Tellagen MCP server — incident investigation platform.
7
7
 
8
- 12 tools: get/list/create incidents, get timeline, start/list/complete investigations, post/list/get/update/promote findings.
8
+ 30 tools across incidents, investigation runs, trace steps, workspace/scope, runbooks, findings, timeline events/comments, impact, affected customers, search, and services.
9
9
 
10
- Investigation lifecycle: get_incident → start_investigation (returns run_id) → gather evidence → post_finding (incrementally, not batched) → promote key findings to timeline → complete_investigation.
10
+ Local investigation lifecycle: if the prompt includes investigation_run_id, first call tellagen_pick_up_investigation with that ID. Otherwise call tellagen_start_investigation, then tellagen_pick_up_investigation. Use the returned context/runbooks, inspect prior trace steps when resuming, post trace steps while gathering evidence, post findings incrementally, promote key findings or post timestamped facts to timeline, and complete the investigation with an RCA result_summary.
11
11
 
12
12
  Findings require: finding_type (observation|correlation|hypothesis|evidence|recommendation|negative), claim, evidence_summary, confidence (0-1), confidence_reason. Attach evidence_refs with source, query, result_summary, url. Attach screenshots (url or base64) to evidence_refs or findings.
13
13
 
@@ -21,7 +21,7 @@ function loadSkillGuide() {
21
21
  export function createServer(client) {
22
22
  const server = new McpServer({
23
23
  name: "tellagen",
24
- version: "0.1.0",
24
+ version: "0.1.3",
25
25
  }, {
26
26
  instructions: INSTRUCTIONS,
27
27
  });
@@ -0,0 +1,3 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { TellagenClient } from "../client.js";
3
+ export declare function registerContextTools(server: McpServer, client: TellagenClient): void;
@@ -0,0 +1,146 @@
1
+ import { z } from "zod";
2
+ import { formatError } from "../errors.js";
3
+ function withQuery(path, params) {
4
+ const query = params.toString();
5
+ return query ? `${path}?${query}` : path;
6
+ }
7
+ export function registerContextTools(server, client) {
8
+ server.registerTool("tellagen_get_impact_summary", {
9
+ description: "Get Tellagen's customer-impact summary for an incident.",
10
+ inputSchema: {
11
+ incident_id: z.number().int().positive().describe("Incident ID"),
12
+ },
13
+ }, async ({ incident_id }) => {
14
+ try {
15
+ const data = await client.get(`/api/v1/incidents/${incident_id}/impact-summary`);
16
+ return {
17
+ content: [{ type: "text", text: JSON.stringify(data) }],
18
+ };
19
+ }
20
+ catch (err) {
21
+ return {
22
+ content: [{ type: "text", text: formatError(err) }],
23
+ isError: true,
24
+ };
25
+ }
26
+ });
27
+ server.registerTool("tellagen_list_affected_customers", {
28
+ description: "List affected customers for an incident, with optional status/email filters and pagination.",
29
+ inputSchema: {
30
+ incident_id: z.number().int().positive().describe("Incident ID"),
31
+ status: z.string().optional(),
32
+ email: z.string().email().optional(),
33
+ limit: z.number().int().min(1).max(50).optional(),
34
+ cursor: z.string().optional(),
35
+ },
36
+ }, async ({ incident_id, status, email, limit, cursor }) => {
37
+ try {
38
+ const params = new URLSearchParams();
39
+ if (status !== undefined)
40
+ params.set("status", status);
41
+ if (email !== undefined)
42
+ params.set("email", email);
43
+ if (limit !== undefined)
44
+ params.set("limit", String(limit));
45
+ if (cursor !== undefined)
46
+ params.set("cursor", cursor);
47
+ const data = await client.get(withQuery(`/api/v1/incidents/${incident_id}/affected-customers`, params));
48
+ return {
49
+ content: [{ type: "text", text: JSON.stringify(data) }],
50
+ };
51
+ }
52
+ catch (err) {
53
+ return {
54
+ content: [{ type: "text", text: formatError(err) }],
55
+ isError: true,
56
+ };
57
+ }
58
+ });
59
+ server.registerTool("tellagen_search", {
60
+ description: "Search Tellagen incidents, timeline events, issues, services, and related workspace records.",
61
+ inputSchema: {
62
+ q: z.string().min(2).optional().describe("Search query"),
63
+ filters: z.string().optional().describe("Advanced filter string"),
64
+ types: z.array(z.string()).optional(),
65
+ incident_id: z.number().int().positive().optional(),
66
+ limit: z.number().int().min(1).max(100).optional(),
67
+ offset: z.number().int().min(0).optional(),
68
+ date_from: z.string().datetime().optional(),
69
+ date_to: z.string().datetime().optional(),
70
+ },
71
+ }, async ({ q, filters, types, incident_id, limit, offset, date_from, date_to, }) => {
72
+ try {
73
+ const params = new URLSearchParams();
74
+ if (q !== undefined)
75
+ params.set("q", q);
76
+ if (filters !== undefined)
77
+ params.set("filters", filters);
78
+ if (types !== undefined && types.length > 0) {
79
+ params.set("types", types.join(","));
80
+ }
81
+ if (incident_id !== undefined) {
82
+ params.set("incident_id", String(incident_id));
83
+ }
84
+ if (limit !== undefined)
85
+ params.set("limit", String(limit));
86
+ if (offset !== undefined)
87
+ params.set("offset", String(offset));
88
+ if (date_from !== undefined)
89
+ params.set("date_from", date_from);
90
+ if (date_to !== undefined)
91
+ params.set("date_to", date_to);
92
+ const data = await client.get(withQuery("/api/v1/search", params));
93
+ return {
94
+ content: [{ type: "text", text: JSON.stringify(data) }],
95
+ };
96
+ }
97
+ catch (err) {
98
+ return {
99
+ content: [{ type: "text", text: formatError(err) }],
100
+ isError: true,
101
+ };
102
+ }
103
+ });
104
+ server.registerTool("tellagen_list_services", {
105
+ description: "List services in the Tellagen service catalog.",
106
+ inputSchema: {
107
+ include_archived: z.boolean().optional(),
108
+ },
109
+ }, async ({ include_archived }) => {
110
+ try {
111
+ const params = new URLSearchParams();
112
+ if (include_archived)
113
+ params.set("include_archived", "true");
114
+ const data = await client.get(withQuery("/api/v1/services", params));
115
+ return {
116
+ content: [{ type: "text", text: JSON.stringify(data) }],
117
+ };
118
+ }
119
+ catch (err) {
120
+ return {
121
+ content: [{ type: "text", text: formatError(err) }],
122
+ isError: true,
123
+ };
124
+ }
125
+ });
126
+ server.registerTool("tellagen_get_service", {
127
+ description: "Get one Tellagen service catalog entry by ID.",
128
+ inputSchema: {
129
+ service_id: z.number().int().positive().describe("Service ID"),
130
+ },
131
+ }, async ({ service_id }) => {
132
+ try {
133
+ const data = await client.get(`/api/v1/services/${service_id}`);
134
+ return {
135
+ content: [{ type: "text", text: JSON.stringify(data) }],
136
+ };
137
+ }
138
+ catch (err) {
139
+ return {
140
+ content: [{ type: "text", text: formatError(err) }],
141
+ isError: true,
142
+ };
143
+ }
144
+ });
145
+ }
146
+ //# sourceMappingURL=context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"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"}
@@ -86,11 +86,16 @@ export function registerIncidentTools(server, client) {
86
86
  .string()
87
87
  .optional()
88
88
  .describe('Severity key (e.g. "sev1", "sev2")'),
89
+ short_title: z
90
+ .string()
91
+ .max(12)
92
+ .optional()
93
+ .describe("Short incident slug used in the Tellagen human ID"),
89
94
  gist: z
90
95
  .string()
91
96
  .max(12)
92
97
  .optional()
93
- .describe("Short slug summary"),
98
+ .describe("Deprecated alias for short_title"),
94
99
  doc_url: z
95
100
  .string()
96
101
  .url()
@@ -115,10 +120,19 @@ export function registerIncidentTools(server, client) {
115
120
  try {
116
121
  const body = {};
117
122
  for (const [key, value] of Object.entries(params)) {
118
- if (value !== undefined) {
123
+ if (value === undefined || key === "gist") {
124
+ continue;
125
+ }
126
+ if (key === "short_title") {
127
+ body.short_title = value;
128
+ }
129
+ else {
119
130
  body[key] = value;
120
131
  }
121
132
  }
133
+ if (body.short_title === undefined && params.gist !== undefined) {
134
+ body.short_title = params.gist;
135
+ }
122
136
  const data = await client.post("/api/v1/incidents", body);
123
137
  return {
124
138
  content: [{ type: "text", text: JSON.stringify(data) }],
@@ -131,5 +145,60 @@ export function registerIncidentTools(server, client) {
131
145
  };
132
146
  }
133
147
  });
148
+ server.registerTool("tellagen_update_incident", {
149
+ description: "Update incident fields that are useful during investigation: status, severity, impact summary, links, and key timestamps.",
150
+ inputSchema: {
151
+ incident_id: z.number().int().positive().describe("Incident ID"),
152
+ service: z.string().optional(),
153
+ regions: z.array(z.string()).optional(),
154
+ severity: z.string().optional(),
155
+ slack_channel_id: z.string().optional(),
156
+ meet_url: z.string().url().optional(),
157
+ doc_url: z.string().url().optional(),
158
+ status: z.string().optional(),
159
+ issue_type: z.string().optional(),
160
+ severity_mode: z.string().optional(),
161
+ impact_summary: z.string().optional(),
162
+ impact_started_at: z
163
+ .string()
164
+ .datetime()
165
+ .optional()
166
+ .describe("ISO timestamp when customer impact started"),
167
+ first_reported_at: z
168
+ .string()
169
+ .datetime()
170
+ .optional()
171
+ .describe("ISO timestamp when the incident was first reported"),
172
+ first_responded_at: z
173
+ .string()
174
+ .datetime()
175
+ .optional()
176
+ .describe("ISO timestamp when response began"),
177
+ recovered_at: z
178
+ .string()
179
+ .datetime()
180
+ .optional()
181
+ .describe("ISO timestamp when impact recovered"),
182
+ },
183
+ }, async ({ incident_id, ...params }) => {
184
+ try {
185
+ const body = {};
186
+ for (const [key, value] of Object.entries(params)) {
187
+ if (value !== undefined) {
188
+ body[key] = value;
189
+ }
190
+ }
191
+ const data = await client.patch(`/api/v1/incidents/${incident_id}`, body);
192
+ return {
193
+ content: [{ type: "text", text: JSON.stringify(data) }],
194
+ };
195
+ }
196
+ catch (err) {
197
+ return {
198
+ content: [{ type: "text", text: formatError(err) }],
199
+ isError: true,
200
+ };
201
+ }
202
+ });
134
203
  }
135
204
  //# sourceMappingURL=incidents.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"incidents.js","sourceRoot":"","sources":["../../src/tools/incidents.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"incidents.js","sourceRoot":"","sources":["../../src/tools/incidents.ts"],"names":[],"mappings":"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"}
@@ -1,10 +1,14 @@
1
1
  import { registerIncidentTools } from "./incidents.js";
2
2
  import { registerInvestigationTools } from "./investigations.js";
3
3
  import { registerFindingTools } from "./findings.js";
4
+ import { registerTimelineTools } from "./timeline.js";
5
+ import { registerContextTools } from "./context.js";
4
6
  /** Register all Tellagen MCP tools on the server. */
5
7
  export function registerAllTools(server, client) {
6
8
  registerIncidentTools(server, client);
7
9
  registerInvestigationTools(server, client);
8
10
  registerFindingTools(server, client);
11
+ registerTimelineTools(server, client);
12
+ registerContextTools(server, client);
9
13
  }
10
14
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAC9B,MAAiB,EACjB,MAAsB;IAEtB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAC9B,MAAiB,EACjB,MAAsB;IAEtB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC"}
@@ -1,30 +1,318 @@
1
1
  import { z } from "zod";
2
2
  import { formatError } from "../errors.js";
3
+ const resultSummarySchema = z
4
+ .object({
5
+ conclusion: z
6
+ .object({
7
+ tone: z.enum(["success", "warning", "danger", "neutral"]),
8
+ eyebrow: z.string(),
9
+ sentence: z.string(),
10
+ show_new_investigation_cta: z.boolean(),
11
+ })
12
+ .describe("Short human-readable conclusion for the RCA record"),
13
+ likely_cause_label: z
14
+ .string()
15
+ .describe("One-line likely cause label, or empty if inconclusive"),
16
+ customer_impact: z.object({
17
+ status: z.enum(["none", "degraded", "outage", "unknown"]),
18
+ verified: z.boolean(),
19
+ label: z.string(),
20
+ evidence_finding_key: z.string().optional(),
21
+ }),
22
+ confidence_percent: z.number().min(0).max(100),
23
+ signals_checked: z.object({
24
+ checked: z.number().int().min(0),
25
+ total: z.number().int().min(0),
26
+ by_source: z.record(z.number().int().min(0)).optional(),
27
+ }),
28
+ takeaways: z.array(z.object({
29
+ id: z.string(),
30
+ title: z.string(),
31
+ body: z.string().optional(),
32
+ description: z.string().optional(),
33
+ severity: z.enum(["high", "medium", "low"]),
34
+ finding_id: z.string().optional(),
35
+ source_url: z.string().optional(),
36
+ })),
37
+ outcome_state: z
38
+ .enum(["successful", "inconclusive", "partial-failure", ""])
39
+ .optional(),
40
+ headline: z.string().optional(),
41
+ })
42
+ .describe("Structured RCA summary shown in Tellagen when the run completes");
43
+ const traceJsonSchema = z
44
+ .unknown()
45
+ .optional()
46
+ .describe("Optional JSON object captured as tool input or result metadata");
47
+ const investigationScopeSchema = z
48
+ .object({
49
+ services: z
50
+ .array(z.object({
51
+ name: z.string().min(1),
52
+ observability_names: z.array(z.string()).optional(),
53
+ }))
54
+ .optional(),
55
+ time_range: z
56
+ .object({
57
+ from: z.string().datetime().optional(),
58
+ to: z.string().datetime().optional(),
59
+ })
60
+ .optional(),
61
+ })
62
+ .describe("Incident-local scope used to guide local investigation tools");
63
+ function generatedStepId(title) {
64
+ const slug = title
65
+ .toLowerCase()
66
+ .replace(/[^a-z0-9]+/g, "-")
67
+ .replace(/^-+|-+$/g, "")
68
+ .slice(0, 40) || "step";
69
+ return `${slug}-${Date.now()}`;
70
+ }
3
71
  export function registerInvestigationTools(server, client) {
4
72
  server.registerTool("tellagen_start_investigation", {
5
- description: "Start a new AI investigation run on a Tellagen incident. Returns the created run with its ID for posting findings.",
73
+ description: "Start a new local AI investigation run on a Tellagen incident when you were not given an investigation_run_id. If Tellagen UI already provided a run ID, use tellagen_pick_up_investigation instead.",
6
74
  inputSchema: {
7
75
  incident_id: z.number().int().positive().describe("Incident ID"),
8
76
  agent_name: z
9
77
  .string()
10
- .min(1)
11
- .describe('Name of the AI agent performing the investigation (e.g., "Claude Code")'),
78
+ .optional()
79
+ .default("local-mcp")
80
+ .describe('Name of the local AI agent performing the investigation (defaults to "local-mcp")'),
12
81
  model_used: z
13
82
  .string()
14
- .min(1)
15
- .describe('Model identifier (e.g., "claude-opus-4-6")'),
83
+ .optional()
84
+ .default("local-llm")
85
+ .describe('Model identifier (defaults to "local-llm")'),
86
+ question: z
87
+ .string()
88
+ .optional()
89
+ .describe("Optional investigation focus or responder question"),
16
90
  data_sources: z
17
91
  .array(z.string())
18
92
  .optional()
19
93
  .describe('List of data sources the agent will consult (e.g., ["codebase", "grafana-loki", "github"])'),
94
+ evidence_budget_preset: z
95
+ .enum(["balanced", "expanded", "maximum"])
96
+ .optional()
97
+ .describe("How much evidence detail Tellagen should expect"),
20
98
  },
21
- }, async ({ incident_id, agent_name, model_used, data_sources }) => {
99
+ }, async ({ incident_id, agent_name, model_used, question, data_sources, evidence_budget_preset, }) => {
22
100
  try {
23
- const data = await client.post(`/api/v1/incidents/${incident_id}/investigations`, {
24
- agent_name,
25
- model_used,
101
+ const body = {
102
+ agent_name: agent_name ?? "local-mcp",
103
+ model_used: model_used ?? "local-llm",
26
104
  data_sources: data_sources ?? [],
27
- });
105
+ execution_mode: "local",
106
+ };
107
+ if (question !== undefined)
108
+ body.question = question;
109
+ if (evidence_budget_preset !== undefined) {
110
+ body.evidence_budget_preset = evidence_budget_preset;
111
+ }
112
+ const data = await client.post(`/api/v1/incidents/${incident_id}/investigations`, body);
113
+ return {
114
+ content: [{ type: "text", text: JSON.stringify(data) }],
115
+ };
116
+ }
117
+ catch (err) {
118
+ return {
119
+ content: [{ type: "text", text: formatError(err) }],
120
+ isError: true,
121
+ };
122
+ }
123
+ });
124
+ server.registerTool("tellagen_get_incident_context", {
125
+ description: "Get the full Tellagen investigation context bundle for an existing run: incident, scope, timeline, prior findings, connectors, matched runbooks/skills, and output schema guidance.",
126
+ inputSchema: {
127
+ investigation_run_id: z
128
+ .string()
129
+ .min(1)
130
+ .describe("Investigation run ID from Tellagen"),
131
+ },
132
+ }, async ({ investigation_run_id }) => {
133
+ try {
134
+ const data = await client.get(`/api/v1/investigations/${investigation_run_id}/context`);
135
+ return {
136
+ content: [{ type: "text", text: JSON.stringify(data) }],
137
+ };
138
+ }
139
+ catch (err) {
140
+ return {
141
+ content: [{ type: "text", text: formatError(err) }],
142
+ isError: true,
143
+ };
144
+ }
145
+ });
146
+ server.registerTool("tellagen_pick_up_investigation", {
147
+ description: "Attach this local MCP agent to a Tellagen investigation run created by the UI. Call this first when the prompt includes an investigation_run_id; it moves the run from awaiting_agent to running and returns the full context bundle.",
148
+ inputSchema: {
149
+ investigation_run_id: z
150
+ .string()
151
+ .min(1)
152
+ .describe("Investigation run ID from the Tellagen UI command"),
153
+ },
154
+ }, async ({ investigation_run_id }) => {
155
+ try {
156
+ const data = await client.post(`/api/v1/investigations/${investigation_run_id}/pickup`, {});
157
+ return {
158
+ content: [{ type: "text", text: JSON.stringify(data) }],
159
+ };
160
+ }
161
+ catch (err) {
162
+ return {
163
+ content: [{ type: "text", text: formatError(err) }],
164
+ isError: true,
165
+ };
166
+ }
167
+ });
168
+ server.registerTool("tellagen_post_trace_step", {
169
+ description: "Post or update a readable investigation trace step for the active run. Use this before and after meaningful tool calls so responders can watch progress live.",
170
+ inputSchema: {
171
+ investigation_run_id: z
172
+ .string()
173
+ .min(1)
174
+ .describe("Active investigation run ID"),
175
+ step_id: z
176
+ .string()
177
+ .optional()
178
+ .describe("Stable ID for updating this same step; generated if omitted"),
179
+ step_index: z
180
+ .number()
181
+ .int()
182
+ .min(0)
183
+ .optional()
184
+ .describe("Display order for this step"),
185
+ status: z
186
+ .enum(["running", "done", "error"])
187
+ .describe("Current step status"),
188
+ tool_name: z
189
+ .string()
190
+ .optional()
191
+ .describe('Source/tool name (e.g., "grafana-loki", "github", "kubectl")'),
192
+ tool_use_id: z
193
+ .string()
194
+ .optional()
195
+ .describe("Optional upstream LLM/tool-call identifier"),
196
+ title: z.string().min(1).describe("Short human-readable step title"),
197
+ result_summary: z
198
+ .string()
199
+ .optional()
200
+ .describe("Short summary of the result or current progress"),
201
+ input_json: traceJsonSchema,
202
+ result_json: traceJsonSchema,
203
+ artifact_id: z.string().optional(),
204
+ artifact_digest: z.string().optional(),
205
+ result_bytes: z.number().int().min(0).optional(),
206
+ truncated: z.boolean().optional(),
207
+ error: z.string().optional(),
208
+ started_at: z
209
+ .string()
210
+ .datetime()
211
+ .optional()
212
+ .describe("ISO timestamp; defaults on the Tellagen server if omitted"),
213
+ completed_at: z
214
+ .string()
215
+ .datetime()
216
+ .optional()
217
+ .describe("ISO timestamp when the step completed"),
218
+ duration_ms: z.number().int().min(0).optional(),
219
+ },
220
+ }, async ({ investigation_run_id, step_id, step_index, status, tool_name, tool_use_id, title, result_summary, input_json, result_json, artifact_id, artifact_digest, result_bytes, truncated, error, started_at, completed_at, duration_ms, }) => {
221
+ try {
222
+ const body = {
223
+ step_id: step_id ?? generatedStepId(title),
224
+ step_index: step_index ?? 0,
225
+ status,
226
+ title,
227
+ };
228
+ if (tool_name !== undefined)
229
+ body.tool_name = tool_name;
230
+ if (tool_use_id !== undefined)
231
+ body.tool_use_id = tool_use_id;
232
+ if (result_summary !== undefined)
233
+ body.result_summary = result_summary;
234
+ if (input_json !== undefined)
235
+ body.input_json = input_json;
236
+ if (result_json !== undefined)
237
+ body.result_json = result_json;
238
+ if (artifact_id !== undefined)
239
+ body.artifact_id = artifact_id;
240
+ if (artifact_digest !== undefined)
241
+ body.artifact_digest = artifact_digest;
242
+ if (result_bytes !== undefined)
243
+ body.result_bytes = result_bytes;
244
+ if (truncated !== undefined)
245
+ body.truncated = truncated;
246
+ if (error !== undefined)
247
+ body.error = error;
248
+ if (started_at !== undefined)
249
+ body.started_at = started_at;
250
+ if (completed_at !== undefined)
251
+ body.completed_at = completed_at;
252
+ if (duration_ms !== undefined)
253
+ body.duration_ms = duration_ms;
254
+ const data = await client.post(`/api/v1/investigation-runs/${investigation_run_id}/trace`, body);
255
+ return {
256
+ content: [{ type: "text", text: JSON.stringify(data) }],
257
+ };
258
+ }
259
+ catch (err) {
260
+ return {
261
+ content: [{ type: "text", text: formatError(err) }],
262
+ isError: true,
263
+ };
264
+ }
265
+ });
266
+ server.registerTool("tellagen_list_trace_steps", {
267
+ description: "List trace steps already posted for an investigation run. Use this when resuming a run to avoid duplicate work.",
268
+ inputSchema: {
269
+ investigation_run_id: z
270
+ .string()
271
+ .min(1)
272
+ .describe("Investigation run ID whose trace should be listed"),
273
+ },
274
+ }, async ({ investigation_run_id }) => {
275
+ try {
276
+ const data = await client.get(`/api/v1/investigation-runs/${investigation_run_id}/trace`);
277
+ return {
278
+ content: [{ type: "text", text: JSON.stringify(data) }],
279
+ };
280
+ }
281
+ catch (err) {
282
+ return {
283
+ content: [{ type: "text", text: formatError(err) }],
284
+ isError: true,
285
+ };
286
+ }
287
+ });
288
+ server.registerTool("tellagen_get_investigation_workspace", {
289
+ description: "Get the incident-level investigation workspace: runs, findings, trace, and review state for an incident.",
290
+ inputSchema: {
291
+ incident_id: z.number().int().positive().describe("Incident ID"),
292
+ },
293
+ }, async ({ incident_id }) => {
294
+ try {
295
+ const data = await client.get(`/api/v1/incidents/${incident_id}/investigations/workspace`);
296
+ return {
297
+ content: [{ type: "text", text: JSON.stringify(data) }],
298
+ };
299
+ }
300
+ catch (err) {
301
+ return {
302
+ content: [{ type: "text", text: formatError(err) }],
303
+ isError: true,
304
+ };
305
+ }
306
+ });
307
+ server.registerTool("tellagen_update_investigation_scope", {
308
+ description: "Update the investigation scope for an incident, including target services, observability aliases, and time range.",
309
+ inputSchema: {
310
+ incident_id: z.number().int().positive().describe("Incident ID"),
311
+ scope: investigationScopeSchema,
312
+ },
313
+ }, async ({ incident_id, scope }) => {
314
+ try {
315
+ const data = await client.patch(`/api/v1/incidents/${incident_id}/investigations/scope`, { scope });
28
316
  return {
29
317
  content: [{ type: "text", text: JSON.stringify(data) }],
30
318
  };
@@ -36,6 +324,34 @@ export function registerInvestigationTools(server, client) {
36
324
  };
37
325
  }
38
326
  });
327
+ server.registerTool("tellagen_list_runbooks", {
328
+ description: "List the runbooks/skills matched for an investigation run. Runbooks are guidance for the local agent, not executable code.",
329
+ inputSchema: {
330
+ investigation_run_id: z
331
+ .string()
332
+ .min(1)
333
+ .describe("Investigation run ID whose matched runbooks should be listed"),
334
+ },
335
+ }, async ({ investigation_run_id }) => {
336
+ try {
337
+ const data = await client.get(`/api/v1/investigations/${investigation_run_id}/context`);
338
+ const context = data;
339
+ return {
340
+ content: [
341
+ {
342
+ type: "text",
343
+ text: JSON.stringify({ runbooks: context.request?.skills ?? [] }),
344
+ },
345
+ ],
346
+ };
347
+ }
348
+ catch (err) {
349
+ return {
350
+ content: [{ type: "text", text: formatError(err) }],
351
+ isError: true,
352
+ };
353
+ }
354
+ });
39
355
  server.registerTool("tellagen_list_investigation_runs", {
40
356
  description: "List all investigation runs for a Tellagen incident. Shows run status, agent info, and finding counts.",
41
357
  inputSchema: {
@@ -56,7 +372,7 @@ export function registerInvestigationTools(server, client) {
56
372
  }
57
373
  });
58
374
  server.registerTool("tellagen_complete_investigation", {
59
- description: 'Complete or fail an investigation run. Set status to "completed" when done, or "failed" with a failure_reason if the investigation could not finish.',
375
+ description: 'Complete or fail an investigation run. Set status to "completed" when done, or "failed" with a failure_reason if the investigation could not finish. Include result_summary for the shared RCA record whenever possible.',
60
376
  inputSchema: {
61
377
  run_id: z.string().min(1).describe("Investigation run ID"),
62
378
  status: z
@@ -66,13 +382,17 @@ export function registerInvestigationTools(server, client) {
66
382
  .string()
67
383
  .optional()
68
384
  .describe('Reason for failure (required when status is "failed")'),
385
+ result_summary: resultSummarySchema.optional(),
69
386
  },
70
- }, async ({ run_id, status, failure_reason }) => {
387
+ }, async ({ run_id, status, failure_reason, result_summary }) => {
71
388
  try {
72
389
  const body = { status };
73
390
  if (failure_reason) {
74
391
  body.failure_reason = failure_reason;
75
392
  }
393
+ if (result_summary !== undefined) {
394
+ body.result_summary = result_summary;
395
+ }
76
396
  const data = await client.patch(`/api/v1/investigations/${run_id}`, body);
77
397
  return {
78
398
  content: [{ type: "text", text: JSON.stringify(data) }],
@@ -1 +1 @@
1
- {"version":3,"file":"investigations.js","sourceRoot":"","sources":["../../src/tools/investigations.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"investigations.js","sourceRoot":"","sources":["../../src/tools/investigations.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { TellagenClient } from "../client.js";
3
+ export declare function registerTimelineTools(server: McpServer, client: TellagenClient): void;
@@ -0,0 +1,160 @@
1
+ import { z } from "zod";
2
+ import { formatError } from "../errors.js";
3
+ const evidenceLinkSchema = z.object({
4
+ source: z.string().min(1),
5
+ url: z.string().url(),
6
+ label: z.string().optional(),
7
+ summary: z.string().optional(),
8
+ });
9
+ const timelineMutationSchema = {
10
+ title: z.string().min(1).optional(),
11
+ body: z.string().optional(),
12
+ type: z.string().optional(),
13
+ icon: z.string().optional(),
14
+ source: z.string().optional(),
15
+ source_ref: z.string().optional(),
16
+ started_at: z.string().datetime().optional(),
17
+ ended_at: z.string().datetime().optional(),
18
+ clear_ended_at: z.boolean().optional(),
19
+ is_ongoing: z.boolean().optional(),
20
+ workstream_id: z.number().int().positive().optional(),
21
+ is_key: z.boolean().optional(),
22
+ tags: z.array(z.string()).optional(),
23
+ ai_context: z.string().optional(),
24
+ source_window_started_at: z.string().datetime().optional(),
25
+ source_window_ended_at: z.string().datetime().optional(),
26
+ evidence_links: z.array(evidenceLinkSchema).optional(),
27
+ };
28
+ function definedBody(input) {
29
+ const body = {};
30
+ for (const [key, value] of Object.entries(input)) {
31
+ if (value !== undefined) {
32
+ body[key] = value;
33
+ }
34
+ }
35
+ return body;
36
+ }
37
+ export function registerTimelineTools(server, client) {
38
+ server.registerTool("tellagen_post_timeline_event", {
39
+ description: "Create a timeline event on an incident for timestamped RCA facts such as deploys, mitigations, customer impact, and verification milestones.",
40
+ inputSchema: {
41
+ incident_id: z.number().int().positive().describe("Incident ID"),
42
+ ...timelineMutationSchema,
43
+ title: z.string().min(1).describe("Timeline event title"),
44
+ },
45
+ }, async ({ incident_id, ...params }) => {
46
+ try {
47
+ const data = await client.post(`/api/v1/incidents/${incident_id}/timeline`, definedBody(params));
48
+ return {
49
+ content: [{ type: "text", text: JSON.stringify(data) }],
50
+ };
51
+ }
52
+ catch (err) {
53
+ return {
54
+ content: [{ type: "text", text: formatError(err) }],
55
+ isError: true,
56
+ };
57
+ }
58
+ });
59
+ server.registerTool("tellagen_get_timeline_event", {
60
+ description: "Get one incident timeline event by ID.",
61
+ inputSchema: {
62
+ timeline_event_id: z
63
+ .number()
64
+ .int()
65
+ .positive()
66
+ .describe("Timeline event ID"),
67
+ },
68
+ }, async ({ timeline_event_id }) => {
69
+ try {
70
+ const data = await client.get(`/api/v1/timeline/${timeline_event_id}`);
71
+ return {
72
+ content: [{ type: "text", text: JSON.stringify(data) }],
73
+ };
74
+ }
75
+ catch (err) {
76
+ return {
77
+ content: [{ type: "text", text: formatError(err) }],
78
+ isError: true,
79
+ };
80
+ }
81
+ });
82
+ server.registerTool("tellagen_update_timeline_event", {
83
+ description: "Update a timeline event title, body, timing, tags, key-event flag, workstream, or evidence links.",
84
+ inputSchema: {
85
+ timeline_event_id: z
86
+ .number()
87
+ .int()
88
+ .positive()
89
+ .describe("Timeline event ID"),
90
+ ...timelineMutationSchema,
91
+ },
92
+ }, async ({ timeline_event_id, ...params }) => {
93
+ try {
94
+ const data = await client.patch(`/api/v1/timeline/${timeline_event_id}`, definedBody(params));
95
+ return {
96
+ content: [{ type: "text", text: JSON.stringify(data) }],
97
+ };
98
+ }
99
+ catch (err) {
100
+ return {
101
+ content: [{ type: "text", text: formatError(err) }],
102
+ isError: true,
103
+ };
104
+ }
105
+ });
106
+ server.registerTool("tellagen_add_timeline_comment", {
107
+ description: "Add a comment to a timeline event, optionally as a reply to an existing comment.",
108
+ inputSchema: {
109
+ timeline_event_id: z
110
+ .number()
111
+ .int()
112
+ .positive()
113
+ .describe("Timeline event ID"),
114
+ body: z.string().min(1).describe("Comment body"),
115
+ parent_id: z
116
+ .number()
117
+ .int()
118
+ .positive()
119
+ .optional()
120
+ .describe("Parent comment ID for a threaded reply"),
121
+ },
122
+ }, async ({ timeline_event_id, body, parent_id }) => {
123
+ try {
124
+ const data = await client.post(`/api/v1/timeline/${timeline_event_id}/comments`, definedBody({ body, parent_id }));
125
+ return {
126
+ content: [{ type: "text", text: JSON.stringify(data) }],
127
+ };
128
+ }
129
+ catch (err) {
130
+ return {
131
+ content: [{ type: "text", text: formatError(err) }],
132
+ isError: true,
133
+ };
134
+ }
135
+ });
136
+ server.registerTool("tellagen_list_timeline_comments", {
137
+ description: "List comments for a timeline event.",
138
+ inputSchema: {
139
+ timeline_event_id: z
140
+ .number()
141
+ .int()
142
+ .positive()
143
+ .describe("Timeline event ID"),
144
+ },
145
+ }, async ({ timeline_event_id }) => {
146
+ try {
147
+ const data = await client.get(`/api/v1/timeline/${timeline_event_id}/comments`);
148
+ return {
149
+ content: [{ type: "text", text: JSON.stringify(data) }],
150
+ };
151
+ }
152
+ catch (err) {
153
+ return {
154
+ content: [{ type: "text", text: formatError(err) }],
155
+ isError: true,
156
+ };
157
+ }
158
+ });
159
+ }
160
+ //# sourceMappingURL=timeline.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../src/tools/timeline.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,15 +1,16 @@
1
1
  {
2
2
  "name": "@tellagen/mcp-server",
3
- "version": "0.1.0",
3
+ "version": "0.1.3",
4
4
  "description": "Tellagen MCP server — investigate incidents with AI agents",
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "bin": {
8
- "tellagen-mcp-server": "./dist/index.js"
8
+ "tellagen-mcp-server": "dist/index.js"
9
9
  },
10
10
  "main": "./dist/index.js",
11
11
  "files": [
12
12
  "dist",
13
+ "server.json",
13
14
  "SKILL.md"
14
15
  ],
15
16
  "scripts": {
package/server.json ADDED
@@ -0,0 +1,35 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.tellagen/mcp-server",
4
+ "description": "Tellagen MCP server — investigate incidents with AI agents, post structured findings, and build incident timelines.",
5
+ "repository": {
6
+ "url": "https://github.com/tellagen/tellagen-mcp-server",
7
+ "source": "github"
8
+ },
9
+ "version": "0.1.3",
10
+ "packages": [
11
+ {
12
+ "registryType": "npm",
13
+ "identifier": "@tellagen/mcp-server",
14
+ "transport": {
15
+ "type": "stdio"
16
+ },
17
+ "environmentVariables": [
18
+ {
19
+ "description": "Tellagen API key (starts with tllg_). Generate one in Settings > API Keys.",
20
+ "isRequired": true,
21
+ "format": "string",
22
+ "isSecret": true,
23
+ "name": "TELLAGEN_API_KEY"
24
+ },
25
+ {
26
+ "description": "Tellagen API base URL (e.g., https://mycompany.api.tellagen.com)",
27
+ "isRequired": true,
28
+ "format": "string",
29
+ "isSecret": false,
30
+ "name": "TELLAGEN_API_URL"
31
+ }
32
+ ]
33
+ }
34
+ ]
35
+ }