@hasna/connectors 0.2.7 → 0.2.9

package/bin/index.js

@@ -6583,7 +6583,7 @@ var PRESETS = {
   commerce: { description: "Commerce and finance", connectors: ["stripe", "shopify", "revolut", "mercury", "pandadoc"] }
 };
 var program2 = new Command;
-program2.name("connectors").description("Install API connectors for your project").version("0.2.7");
+program2.name("connectors").description("Install API connectors for your project").version("0.2.9");
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
   if (!isTTY) {
     console.log(`Non-interactive environment detected. Use a subcommand:
@@ -7746,7 +7746,7 @@ program2.command("import").argument("<file>", "JSON backup file to import (use -
   }
 });
 program2.command("upgrade").alias("self-update").option("--check", "Only check for updates, don't install", false).option("--json", "Output as JSON", false).description("Check for updates and upgrade to the latest version").action(async (options) => {
-  const currentVersion = "0.2.7";
+  const currentVersion = "0.2.9";
   try {
     const res = await fetch("https://registry.npmjs.org/@hasna/connectors/latest");
     if (!res.ok)
@@ -7962,7 +7962,7 @@ Available presets:
 program2.command("whoami").option("--json", "Output as JSON", false).description("Show current setup: config dir, installed connectors, auth status").action((options) => {
   const configDir = join5(homedir3(), ".connectors");
   const installed = getInstalledConnectors();
-  const version = "0.2.7";
+  const version = "0.2.9";
   let configured = 0;
   let unconfigured = 0;
   const connectorDetails = [];

package/bin/mcp.js

@@ -20275,13 +20275,13 @@ function guessKeyField(name) {
 loadConnectorVersions();
 var server = new McpServer({
   name: "connectors",
-  version: "0.2.7"
+  version: "0.2.9"
 });
 server.registerTool("search_connectors", {
   title: "Search Connectors",
-  description: "Search the connector library by name, description, or keyword. " + "Use this to discover available API connectors (e.g. 'payment', 'ai', 'email').",
+  description: "Search connectors by name, keyword, or description.",
   inputSchema: {
-    query: exports_external.string().describe("Search query (name, keyword, or description)")
+    query: exports_external.string().describe("Search query")
   }
 }, async ({ query }) => {
   const results = searchConnectors(query);
@@ -20302,11 +20302,12 @@ server.registerTool("search_connectors", {
 });
 server.registerTool("list_connectors", {
   title: "List Connectors",
-  description: "List all available connectors, optionally filtered by category. " + "Returns name, version, category, and description for each connector.",
+  description: "List connectors, optionally filtered by category. Use compact=true for names only.",
   inputSchema: {
-    category: exports_external.string().optional().describe("Filter by category. Available: " + CATEGORIES.join(", "))
+    category: exports_external.string().optional().describe("Filter by category (e.g. 'AI & ML', 'Developer Tools')"),
+    compact: exports_external.boolean().optional().describe("Return names only (default: false)")
   }
-}, async ({ category }) => {
+}, async ({ category, compact }) => {
   let connectors = CONNECTORS;
   if (category) {
     const matched = CATEGORIES.find((c) => c.toLowerCase() === category.toLowerCase());
@@ -20323,28 +20324,25 @@ server.registerTool("list_connectors", {
     }
     connectors = getConnectorsByCategory(matched);
   }
+  const data = compact ? connectors.map((c) => c.name) : connectors.map((c) => ({
+    name: c.name,
+    displayName: c.displayName,
+    version: c.version,
+    category: c.category,
+    description: c.description
+  }));
   return {
-    content: [
-      {
-        type: "text",
-        text: JSON.stringify(connectors.map((c) => ({
-          name: c.name,
-          displayName: c.displayName,
-          version: c.version,
-          category: c.category,
-          description: c.description
-        })), null, 2)
-      }
-    ]
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
   };
 });
 server.registerTool("connector_docs", {
   title: "Connector Documentation",
-  description: "Get detailed documentation for a connector including auth method, " + "required environment variables, CLI commands, and API capabilities. " + "Use this BEFORE installing a connector to understand how to use it.",
+  description: "Get connector docs. Use essential=true for auth+envVars only (faster).",
   inputSchema: {
-    name: exports_external.string().describe("Connector name (e.g. 'stripe', 'anthropic', 'gmail')")
+    name: exports_external.string().describe("Connector name"),
+    essential: exports_external.boolean().optional().describe("Return auth+envVars only (default: false)")
   }
-}, async ({ name }) => {
+}, async ({ name, essential }) => {
   const meta = getConnector(name);
   if (!meta) {
     return {
@@ -20359,32 +20357,28 @@ server.registerTool("connector_docs", {
       isError: true
     };
   }
+  const data = essential ? { name: meta.name, auth: docs.auth, envVars: docs.envVars } : {
+    name: meta.name,
+    displayName: meta.displayName,
+    version: meta.version,
+    category: meta.category,
+    description: meta.description,
+    overview: docs.overview,
+    auth: docs.auth,
+    envVars: docs.envVars,
+    cliCommands: docs.cliCommands,
+    dataStorage: docs.dataStorage
+  };
   return {
-    content: [
-      {
-        type: "text",
-        text: JSON.stringify({
-          name: meta.name,
-          displayName: meta.displayName,
-          version: meta.version,
-          category: meta.category,
-          description: meta.description,
-          overview: docs.overview,
-          auth: docs.auth,
-          envVars: docs.envVars,
-          cliCommands: docs.cliCommands,
-          dataStorage: docs.dataStorage
-        }, null, 2)
-      }
-    ]
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
   };
 });
 server.registerTool("install_connector", {
   title: "Install Connector",
-  description: "Install one or more API connectors into the current project. " + "Connectors are copied to .connectors/ with an auto-generated index.ts for imports.",
+  description: "Install connectors into .connectors/ directory.",
   inputSchema: {
-    names: exports_external.array(exports_external.string()).describe("Connector names to install (e.g. ['stripe', 'figma'])"),
-    overwrite: exports_external.boolean().optional().describe("Overwrite if already installed (default: false)")
+    names: exports_external.array(exports_external.string()).describe("Connector names to install"),
+    overwrite: exports_external.boolean().optional().describe("Overwrite if already installed")
   }
 }, async ({ names, overwrite }) => {
   const results = names.map((name) => installConnector(name, { overwrite: overwrite ?? false }));
@@ -20422,7 +20416,7 @@ server.registerTool("remove_connector", {
 });
 server.registerTool("list_installed", {
   title: "List Installed Connectors",
-  description: "List connectors currently installed in the project's .connectors/ directory.",
+  description: "List connectors installed in .connectors/.",
   inputSchema: {}
 }, async () => {
   const installed = getInstalledConnectors();
@@ -20437,7 +20431,7 @@ server.registerTool("list_installed", {
 });
 server.registerTool("connector_info", {
   title: "Connector Info",
-  description: "Get metadata about a specific connector including version, category, " + "tags, and whether it's currently installed.",
+  description: "Get connector metadata and installed status.",
   inputSchema: {
     name: exports_external.string().describe("Connector name")
   }
@@ -20462,9 +20456,9 @@ server.registerTool("connector_info", {
 });
 server.registerTool("connector_auth_status", {
   title: "Connector Auth Status",
-  description: "Check the authentication status of an installed connector. " + "Returns auth type (oauth/apikey/bearer), whether it's configured, " + "token expiry for OAuth connectors, and environment variable status.",
+  description: "Check connector auth status, token expiry, and env vars.",
   inputSchema: {
-    name: exports_external.string().describe("Connector name (e.g. 'gmail', 'stripe', 'anthropic')")
+    name: exports_external.string().describe("Connector name")
   }
 }, async ({ name }) => {
   const meta = getConnector(name);
@@ -20490,11 +20484,11 @@ server.registerTool("connector_auth_status", {
 });
 server.registerTool("configure_auth", {
   title: "Configure Auth",
-  description: "Save an API key or bearer token for a connector. " + "Stores credentials in ~/.connectors/connect-{name}/profiles/. " + "Use connector_docs to find required env vars and field names first.",
+  description: "Save an API key or bearer token for a connector.",
   inputSchema: {
-    name: exports_external.string().describe("Connector name (e.g. 'stripe', 'anthropic', 'openai')"),
-    key: exports_external.string().describe("The API key or bearer token value"),
-    field: exports_external.string().optional().describe("Key field name (defaults to the connector's primary key field, usually 'apiKey')")
+    name: exports_external.string().describe("Connector name"),
+    key: exports_external.string().describe("API key or bearer token"),
+    field: exports_external.string().optional().describe("Field name (default: 'apiKey')")
   }
 }, async ({ name, key, field }) => {
   try {
@@ -20521,7 +20515,7 @@ server.registerTool("configure_auth", {
 });
 server.registerTool("list_categories", {
   title: "List Categories",
-  description: "List all connector categories with the number of connectors in each.",
+  description: "List connector categories with counts.",
   inputSchema: {}
 }, async () => {
   const categoryCounts = CATEGORIES.map((category) => ({
@@ -20537,6 +20531,53 @@ server.registerTool("list_categories", {
     ]
   };
 });
+server.registerTool("search_tools", {
+  title: "Search Tools",
+  description: "List tool names, optionally filtered by keyword.",
+  inputSchema: {
+    query: exports_external.string().optional().describe("Keyword filter")
+  }
+}, async ({ query }) => {
+  const all = [
+    "search_connectors",
+    "list_connectors",
+    "connector_docs",
+    "install_connector",
+    "remove_connector",
+    "list_installed",
+    "connector_info",
+    "connector_auth_status",
+    "configure_auth",
+    "list_categories",
+    "search_tools",
+    "describe_tools"
+  ];
+  const matches = query ? all.filter((n) => n.includes(query.toLowerCase())) : all;
+  return { content: [{ type: "text", text: matches.join(", ") }] };
+});
+server.registerTool("describe_tools", {
+  title: "Describe Tools",
+  description: "Get descriptions for specific tools by name.",
+  inputSchema: {
+    names: exports_external.array(exports_external.string()).describe("Tool names")
+  }
+}, async ({ names }) => {
+  const descriptions = {
+    search_connectors: "Search connectors by name/keyword. Params: query",
+    list_connectors: "List connectors by category. Params: category, compact",
+    connector_docs: "Get auth, env vars, CLI docs. Params: name, essential?",
+    install_connector: "Install connector. Params: names, overwrite?",
+    remove_connector: "Remove installed connector. Params: name",
+    list_installed: "List installed connectors.",
+    connector_info: "Get metadata and install status. Params: name",
+    connector_auth_status: "Check auth status and env vars. Params: name",
+    configure_auth: "Save API key or token. Params: name, key, field?",
+    list_categories: "List connector categories with counts."
+  };
+  const result = names.map((n) => `${n}: ${descriptions[n] || "See tool schema"}`).join(`
+`);
+  return { content: [{ type: "text", text: result }] };
+});
 async function main() {
   const transport = new StdioServerTransport;
   await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {