@2kw/ai-mcp-server 8.2.0-dev.9 → 8.3.0-dev.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.
@@ -51,7 +51,7 @@ export function register(server, client) {
51
51
  };
52
52
  }
53
53
  });
54
- server.tool("2kw_create_provider", "Register a new BYOK provider with credentials. Requires an API key belonging to the external provider, except for OLLAMA.", {
54
+ server.tool("2kw_create_provider", "Register a new BYOK provider with credentials. Requires an API key belonging to the external provider, except for OLLAMA. Needs an admin or owner key.", {
55
55
  name: z.string(),
56
56
  provider: ProviderType.describe("Provider vendor type"),
57
57
  apiKey: z.string().optional().describe("Credential for the external provider (not needed for OLLAMA)"),
@@ -80,7 +80,7 @@ export function register(server, client) {
80
80
  };
81
81
  }
82
82
  });
83
- server.tool("2kw_update_provider", "Patch an existing provider. Only supplied fields are updated.", {
83
+ server.tool("2kw_update_provider", "Patch an existing provider. Only supplied fields are updated. Needs an admin or owner key.", {
84
84
  id: z.string(),
85
85
  name: z.string().optional(),
86
86
  provider: ProviderType.optional(),
@@ -109,7 +109,7 @@ export function register(server, client) {
109
109
  };
110
110
  }
111
111
  });
112
- server.tool("2kw_delete_provider", "Delete a provider. Existing extractions that used it keep their past records.", { id: z.string() }, async (params) => {
112
+ server.tool("2kw_delete_provider", "Delete a provider. Existing extractions that used it keep their past records. Needs an admin or owner key.", { id: z.string() }, async (params) => {
113
113
  try {
114
114
  await client.DELETE("/v1/providers/{id}", {
115
115
  params: { path: { id: params.id } },
@@ -141,7 +141,7 @@ export function register(server, client) {
141
141
  };
142
142
  }
143
143
  });
144
- server.tool("2kw_test_provider", "Test connectivity/credentials for an AI provider before (or without) saving it. Pass a fresh apiKey to test ad-hoc credentials, or providerId to re-test an existing provider's stored key.", {
144
+ server.tool("2kw_test_provider", "Test connectivity/credentials for an AI provider before (or without) saving it. Pass a fresh apiKey to test ad-hoc credentials, or providerId to re-test an existing provider's stored key. Needs an admin or owner key.", {
145
145
  provider: ProviderType.describe("Provider vendor type"),
146
146
  apiKey: z.string().optional().describe("Credential to test (omit to use providerId's stored key)"),
147
147
  providerId: z.string().optional().describe("Existing provider ID whose stored credentials should be used"),
@@ -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.2.0-dev.9",
3
+ "version": "8.3.0-dev.3",
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": [