@2kw/ai-mcp-server 8.2.0 → 8.3.0-dev.12
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/dist/tools/agents.js +46 -5
- package/dist/tools/tracing.js +10 -3
- package/package.json +1 -1
package/dist/tools/agents.js
CHANGED
|
@@ -75,7 +75,7 @@ export function register(server, client) {
|
|
|
75
75
|
});
|
|
76
76
|
// ── list_agent_catalog ──────────────────────────────────────────────────
|
|
77
77
|
server.tool("2kw_list_agent_catalog", "List published agents as id, name and description. This is the read a chat-only USER "
|
|
78
|
-
+ "key may perform; 2kw_list_agents carries the operator configuration and needs
|
|
78
|
+
+ "key may perform; 2kw_list_agents carries the operator configuration and needs MEMBER or above.", {
|
|
79
79
|
search: z.string().optional().describe("Filter agents by name"),
|
|
80
80
|
page: z.number().optional().default(0).describe("Page number (0-based)"),
|
|
81
81
|
size: z.number().optional().default(20).describe("Page size"),
|
|
@@ -134,7 +134,15 @@ export function register(server, client) {
|
|
|
134
134
|
tools: z.unknown().optional().describe("Tool configuration (JSON object)"),
|
|
135
135
|
skills: z.unknown().optional().describe("Skill configuration (JSON object)"),
|
|
136
136
|
hitlPolicy: z.unknown().optional().describe("Human-in-the-loop approval policy (JSON object)"),
|
|
137
|
-
|
|
137
|
+
visibility: z
|
|
138
|
+
.enum(["organization", "restricted"])
|
|
139
|
+
.optional()
|
|
140
|
+
.describe("Who may use the agent: `organization` (default) for every member, `restricted` for members of `teamIds` only. A member may restrict an agent only to teams they belong to"),
|
|
141
|
+
teamIds: z
|
|
142
|
+
.array(z.string().min(1))
|
|
143
|
+
.optional()
|
|
144
|
+
.describe("The teams a restricted agent is open to; omit for `organization`"),
|
|
145
|
+
}, async ({ name, model, models, description, instructions, options, tools, skills, hitlPolicy, visibility, teamIds }) => {
|
|
138
146
|
try {
|
|
139
147
|
const body = { name, ...modelFields(model, models, true) };
|
|
140
148
|
if (description !== undefined)
|
|
@@ -149,11 +157,15 @@ export function register(server, client) {
|
|
|
149
157
|
body.skills = skills;
|
|
150
158
|
if (hitlPolicy !== undefined)
|
|
151
159
|
body.hitlPolicy = hitlPolicy;
|
|
160
|
+
if (visibility !== undefined)
|
|
161
|
+
body.visibility = visibility;
|
|
162
|
+
if (teamIds !== undefined)
|
|
163
|
+
body.teamIds = teamIds;
|
|
152
164
|
const { data } = await client.POST("/v1/agents", {
|
|
153
165
|
body: body,
|
|
154
166
|
});
|
|
155
|
-
// Create publishes version 1; an older backend does not, so publish then (#668).
|
|
156
|
-
const { name: _name, description: _description, ...configuration } = body;
|
|
167
|
+
// Create publishes version 1; an older backend does not, so publish then (#668). Access is not version config.
|
|
168
|
+
const { name: _name, description: _description, visibility: _visibility, teamIds: _teamIds, ...configuration } = body;
|
|
157
169
|
await ensurePublished(client, data, { ...configuration, changeDescription: "Initial version" });
|
|
158
170
|
return {
|
|
159
171
|
content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
|
|
@@ -240,6 +252,35 @@ export function register(server, client) {
|
|
|
240
252
|
};
|
|
241
253
|
}
|
|
242
254
|
});
|
|
255
|
+
// ── get_agent_access / set_agent_access ─────────────────────────────────
|
|
256
|
+
server.tool("2kw_get_agent_access", "Show who may use an agent: everyone in the organization (`organization`), or only members of the listed teams (`restricted`). Administrators and owners reach every agent.", { agentId: z.string().describe("The agent ID") }, async ({ agentId }) => {
|
|
257
|
+
try {
|
|
258
|
+
const { data } = await client.GET("/v1/agents/{id}/access", { params: { path: { id: agentId } } });
|
|
259
|
+
return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
|
|
260
|
+
}
|
|
261
|
+
catch (error) {
|
|
262
|
+
return { content: [{ type: "text", text: formatErrorForMcp(error) }], isError: true };
|
|
263
|
+
}
|
|
264
|
+
});
|
|
265
|
+
server.tool("2kw_set_agent_access", "Replace who may use an agent. `organization` opens it to every member and takes no teams; `restricted` limits it to members of `teamIds` (with no team: administrators and owners only). Administrators and owners only. The organization's default agent cannot be restricted.", {
|
|
266
|
+
agentId: z.string().describe("The agent ID"),
|
|
267
|
+
visibility: z.enum(["organization", "restricted"]).describe("Who may use the agent"),
|
|
268
|
+
teamIds: z
|
|
269
|
+
.array(z.string().min(1))
|
|
270
|
+
.optional()
|
|
271
|
+
.describe("The teams a restricted agent is open to; omit for `organization`"),
|
|
272
|
+
}, async ({ agentId, visibility, teamIds }) => {
|
|
273
|
+
try {
|
|
274
|
+
const { data } = await client.PUT("/v1/agents/{id}/access", {
|
|
275
|
+
params: { path: { id: agentId } },
|
|
276
|
+
body: { visibility, teamIds: teamIds ?? [] },
|
|
277
|
+
});
|
|
278
|
+
return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
|
|
279
|
+
}
|
|
280
|
+
catch (error) {
|
|
281
|
+
return { content: [{ type: "text", text: formatErrorForMcp(error) }], isError: true };
|
|
282
|
+
}
|
|
283
|
+
});
|
|
243
284
|
// ── list_agent_versions ─────────────────────────────────────────────────
|
|
244
285
|
server.tool("2kw_list_agent_versions", "List version history for an agent, with pagination.", {
|
|
245
286
|
agentId: z.string().describe("The agent ID"),
|
|
@@ -332,7 +373,7 @@ export function register(server, client) {
|
|
|
332
373
|
// ── list_agent_skills ───────────────────────────────────────────────────
|
|
333
374
|
server.tool("2kw_list_agent_skills", "List the skills an agent's latest published version binds, in authored order. This is the "
|
|
334
375
|
+ "read a chat-only USER key may perform; 2kw_get_latest_agent_version carries the full version "
|
|
335
|
-
+ "and needs
|
|
376
|
+
+ "and needs MEMBER or above. An agent with no published version lists none.", { agentId: z.string().describe("The agent ID") }, async ({ agentId }) => {
|
|
336
377
|
try {
|
|
337
378
|
const { data } = await client.GET("/v1/agents/{agentId}/skills", {
|
|
338
379
|
params: { path: { agentId } },
|
package/dist/tools/tracing.js
CHANGED
|
@@ -60,7 +60,7 @@ export function register(server, client) {
|
|
|
60
60
|
}
|
|
61
61
|
});
|
|
62
62
|
// ── traces ──────────────────────────────────────────────────────────────
|
|
63
|
-
server.tool("2kw_list_traces", "List recent traces in the org. Traces are aggregated by trace_id across all spans. Optional filters: source service, status code (OK/ERROR/UNSET, CSV for multiple), free-text search across trace id + span name + service + backbone.operation.", {
|
|
63
|
+
server.tool("2kw_list_traces", "List recent traces in the org. Traces are aggregated by trace_id across all spans. Optional filters: source service, status code (OK/ERROR/UNSET, CSV for multiple), free-text search across trace id + span name + service + backbone.operation, and a start-time range. Without from, the server lists the 7 days before to, or before now.", {
|
|
64
64
|
sourceService: z.string().optional().describe("Filter by source_service"),
|
|
65
65
|
statusCode: z
|
|
66
66
|
.string()
|
|
@@ -70,6 +70,11 @@ export function register(server, client) {
|
|
|
70
70
|
.string()
|
|
71
71
|
.optional()
|
|
72
72
|
.describe("Free-text search across trace id / span name / service / operation"),
|
|
73
|
+
from: z
|
|
74
|
+
.string()
|
|
75
|
+
.optional()
|
|
76
|
+
.describe("Start of time range (ISO-8601). Default: the 7 days before `to`, or before now"),
|
|
77
|
+
to: z.string().optional().describe("End of time range (ISO-8601)"),
|
|
73
78
|
page: z.number().int().min(0).optional().describe("Page index (0-based)"),
|
|
74
79
|
size: z.number().int().min(1).max(100).optional().describe("Page size"),
|
|
75
80
|
}, async (params) => {
|
|
@@ -80,6 +85,8 @@ export function register(server, client) {
|
|
|
80
85
|
sourceService: params.sourceService,
|
|
81
86
|
statusCode: params.statusCode,
|
|
82
87
|
search: params.search,
|
|
88
|
+
from: params.from,
|
|
89
|
+
to: params.to,
|
|
83
90
|
page: params.page ?? 0,
|
|
84
91
|
size: params.size ?? 20,
|
|
85
92
|
},
|
|
@@ -129,13 +136,13 @@ export function register(server, client) {
|
|
|
129
136
|
}
|
|
130
137
|
});
|
|
131
138
|
// ── sessions ────────────────────────────────────────────────────────────
|
|
132
|
-
server.tool("2kw_list_trace_sessions", "List sessions (spans grouped by an exporter-stamped session id) in the org, with turn/error counts, duration, tokens and cost. Optional free-text search across session id and name, an exact session id match, and a start-time range. Each line starts with the session's own id, which 2kw_get_trace_session takes.", {
|
|
139
|
+
server.tool("2kw_list_trace_sessions", "List sessions (spans grouped by an exporter-stamped session id) in the org, with turn/error counts, duration, tokens and cost. Optional free-text search across session id and name, an exact session id match, and a start-time range. Without from, the server lists the 7 days before to, or before now. Each line starts with the session's own id, which 2kw_get_trace_session takes.", {
|
|
133
140
|
search: z.string().optional().describe("Free-text search across session id and name"),
|
|
134
141
|
sessionId: z
|
|
135
142
|
.string()
|
|
136
143
|
.optional()
|
|
137
144
|
.describe("Exact match on the session.id the exporter stamped (slashes allowed)"),
|
|
138
|
-
from: z.string().optional().describe("Start of time range (ISO-8601)"),
|
|
145
|
+
from: z.string().optional().describe("Start of time range (ISO-8601). Default: the 7 days before `to`, or before now"),
|
|
139
146
|
to: z.string().optional().describe("End of time range (ISO-8601)"),
|
|
140
147
|
page: z.number().int().min(0).optional().describe("Page index (0-based)"),
|
|
141
148
|
size: z.number().int().min(1).max(100).optional().describe("Page size"),
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@2kw/ai-mcp-server",
|
|
3
|
-
"version": "8.
|
|
3
|
+
"version": "8.3.0-dev.12",
|
|
4
4
|
"description": "MCP server for 2kw.ai — EU-hosted AI platform: OpenAI-compatible LLM gateway, schema-driven document extraction, transcription, agents with a knowledge base, and cost observability. 199 tools for Claude Code, Cursor, and Windsurf.",
|
|
5
5
|
"mcpName": "ai.2kw/mcp-server",
|
|
6
6
|
"keywords": [
|