@pairsystems/goodmem-mcp 0.1.12 → 0.1.13

package/dist/index.js

@@ -21927,7 +21927,7 @@ function autoInferFromRegistry(registryType, args) {
 }
 var server = new McpServer({
   name: "goodmem",
-  version: "0.1.12"
+  version: "0.1.13"
 });
 server.tool("goodmem_configure", "Configure GoodMem server connection. Call this before using other GoodMem tools if GOODMEM_BASE_URL and GOODMEM_API_KEY environment variables are not set. Session credentials override environment variables.", {
   base_url: external_exports.string().describe("GoodMem server URL (e.g., https://your-server.example.com)"),
@@ -21994,7 +21994,7 @@ ${allModels.join("\n")}` }] };
 });
 server.tool("goodmem_client_info", "Return the MCP client package version and the goodmem server commit it was built against. No server connection required.", {}, async () => {
   return { content: [{ type: "text", text: JSON.stringify({
-    mcpVersion: "0.1.12",
+    mcpVersion: "0.1.13",
     basedOnGoodmemCommit: BASED_ON_GOODMEM_COMMIT
   }, null, 2) }] };
 });
@@ -22104,7 +22104,7 @@ function registerTools() {
         quotaProjectId: external_exports.string().describe("Optional quota project used for billing").optional()
       }).passthrough().describe("Configuration when kind is CREDENTIAL_KIND_GCP_ADC").optional(),
       labels: external_exports.any().describe('Optional annotations to aid operators (e.g., "owner=vertex")').optional()
-    }).passthrough().describe("Structured credential payload describing how to authenticate with the provider. Required for SaaS providers such as COHERE, JINA, and VOYAGE; optional for local or proxy providers.").optional(),
+    }).passthrough().describe("Structured credential payload describing how to authenticate with the provider. Required for SaaS providers; optional for local or proxy providers.").optional(),
     labels: external_exports.record(external_exports.string(), external_exports.string()).describe("User-defined labels for categorization").optional(),
     version: external_exports.string().describe("Version information").optional(),
     monitoring_endpoint: external_exports.string().describe("Monitoring endpoint URL").optional(),
@@ -22267,7 +22267,7 @@ function registerTools() {
         quotaProjectId: external_exports.string().describe("Optional quota project used for billing").optional()
       }).passthrough().describe("Configuration when kind is CREDENTIAL_KIND_GCP_ADC").optional(),
       labels: external_exports.any().describe('Optional annotations to aid operators (e.g., "owner=vertex")').optional()
-    }).passthrough().describe("Structured credential payload describing how to authenticate with the provider. Omit for deployments that do not require credentials.").optional(),
+    }).passthrough().describe("Structured credential payload describing how to authenticate with the provider. Required for SaaS providers; optional for local or proxy providers.").optional(),
     labels: external_exports.record(external_exports.string(), external_exports.string()).describe("User-defined labels for categorization").optional(),
     version: external_exports.string().describe("Version information").optional(),
     monitoring_endpoint: external_exports.string().describe("Monitoring endpoint URL").optional(),
@@ -22512,7 +22512,7 @@ function registerTools() {
     const result = await callApi("POST", `/v1/memories:batchGet`, body);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
-  server.tool("goodmem_memories_create", "Create a new memory", {
+  server.tool("goodmem_memories_create", "Create a memory from text content or base64-encoded content. Content must be provided via exactly one of `original_content` or `original_content_b64`.", {
     memory_id: external_exports.string().describe("Optional client-provided UUID for the memory. If omitted, the server generates one. Returns ALREADY_EXISTS if the ID is already in use.").optional(),
     space_id: external_exports.string().describe("ID of the space where this memory will be stored"),
     original_content: external_exports.string().describe("Original content as plain text (use either this or originalContentB64)").optional(),
@@ -22583,7 +22583,7 @@ function registerTools() {
     const result = await callApi("GET", `/v1/memories/${encodeURIComponent(String(args.id))}`, void 0, query);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
-  server.tool("goodmem_memories_list", "List memories in a space", {
+  server.tool("goodmem_memories_list", "Lists memories within a given space. Results are paginated \u2014 the returned `Page` eagerly fetches the first page. Access `.data` for items and `.next_token` to resume. Use `for mem in page` to auto-paginate all pages, `page_size` to control items per API call, and `max_items` to cap total results.", {
     space_id: external_exports.string().describe("The UUID of the space containing the memories"),
     include_content: external_exports.boolean().describe("Whether to include the original content in the response (defaults to false).").optional(),
     include_processing_history: external_exports.boolean().describe("Whether to include background job processing history in the response (defaults to false).").optional(),
@@ -22639,7 +22639,7 @@ function registerTools() {
     const result = await callApi("GET", `/v1/memories/${encodeURIComponent(String(args.id))}/pages`, void 0, query);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
-  server.tool("goodmem_memories_retrieve", "Advanced semantic memory retrieval with JSON", {
+  server.tool("goodmem_memories_retrieve", "Performs a streaming semantic search across one or more memory spaces and returns matching chunks ranked by relevance as well as LLM-postprocessed results (like summarization, question-answering, etc.).", {
     message: external_exports.string().describe("Primary query/message for semantic search."),
     context: external_exports.array(external_exports.object({
       text: external_exports.string().describe("Text content for this context item.").optional(),
@@ -22694,7 +22694,7 @@ function registerTools() {
     const result = await callApiNdjson("POST", `/v1/memories:retrieve`, body, void 0, args.timeout_sec);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
-  server.tool("goodmem_ocr_document", "Run OCR on a document or image", {
+  server.tool("goodmem_ocr_document", "Run OCR on a document or image. Pass base64-encoded document bytes as `content`. Optionally specify `format` (e.g., PDF, PNG) \u2014 if omitted, the server auto-detects.", {
     content: external_exports.string().describe("Base64-encoded document bytes"),
     format: external_exports.enum(["AUTO", "PDF", "TIFF", "PNG", "JPEG", "BMP"]).describe("Input format hint (AUTO, PDF, TIFF, PNG, JPEG, BMP)").optional(),
     include_raw_json: external_exports.boolean().describe("Include raw OCR JSON payload in the response").optional(),
@@ -22742,7 +22742,7 @@ function registerTools() {
         quotaProjectId: external_exports.string().describe("Optional quota project used for billing").optional()
       }).passthrough().describe("Configuration when kind is CREDENTIAL_KIND_GCP_ADC").optional(),
       labels: external_exports.any().describe('Optional annotations to aid operators (e.g., "owner=vertex")').optional()
-    }).passthrough().describe("Structured credential payload describing how to authenticate with the provider. Required for SaaS providers; optional for local deployments.").optional(),
+    }).passthrough().describe("Structured credential payload describing how to authenticate with the provider. Required for SaaS providers; optional for local or proxy providers.").optional(),
     labels: external_exports.record(external_exports.string(), external_exports.string()).describe("User-defined labels for categorization").optional(),
     version: external_exports.string().describe("Version information").optional(),
     monitoring_endpoint: external_exports.string().describe("Monitoring endpoint URL").optional(),
@@ -22924,7 +22924,7 @@ function registerTools() {
     const result = await callApi("GET", `/v1/spaces/${encodeURIComponent(String(args.id))}`, void 0);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
-  server.tool("goodmem_spaces_list", "List spaces", {
+  server.tool("goodmem_spaces_list", "List spaces accessible to the caller, with optional filtering by owner, labels, and name. Results are paginated \u2014 the returned `Page` eagerly fetches the first page. Access `.data` for items and `.next_token` to resume. Use `for space in page` to auto-paginate all pages, `page_size` to control items per API call, and `max_items` to cap total results.", {
     owner_id: external_exports.string().describe("Filter spaces by owner ID. With LIST_SPACE_ANY permission and ownerId omitted, returns all visible spaces. Otherwise returns caller-owned spaces only. Specifying ownerId without LIST_SPACE_ANY returns PERMISSION_DENIED.").optional(),
     name_filter: external_exports.string().describe("Filter spaces by name using glob pattern matching").optional(),
     max_results: external_exports.number().int().describe("Maximum number of results to return in a single page (defaults to 50, clamped to [1, 1000])").optional(),
@@ -22980,7 +22980,7 @@ function registerTools() {
     const result = await callApi("POST", `/v1/system/init`, void 0);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
-  server.tool("goodmem_users_get", "Get a user by ID", {
+  server.tool("goodmem_users_get", "Retrieves a user by ID or email address. Exactly one of `id` and `email` must be provided. For getting your own profile, use `client.users.me()`.", {
     id: external_exports.string().describe("The UUID of the user to retrieve").optional(),
     email: external_exports.string().describe("The email address of the user to retrieve").optional()
   }, async (args) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pairsystems/goodmem-mcp",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "GoodMem MCP server \u2014 exposes GoodMem API as MCP tools",
   "type": "module",
   "main": "dist/index.js",