@steuerboard/mcp 0.3.0 → 0.3.4

package/README.md

@@ -22,6 +22,7 @@ For more information about the API: [Find out more about Steuerboard API](https:
 <!-- $toc-max-depth=2 -->
 * [Steuerboard TypeScript MCP Server](#steuerboard-typescript-mcp-server)
   * [Installation](#installation)
+  * [Progressive Discovery](#progressive-discovery)
   * [Development](#development)
   * [Contributions](#contributions)
 
@@ -147,6 +148,34 @@ npx @steuerboard/mcp --help
 </details>
 <!-- End Installation [installation] -->
 
+<!-- Start Progressive Discovery [dynamic-mode] -->
+## Progressive Discovery
+
+MCP servers with many tools can bloat LLM context windows, leading to increased token usage and tool confusion. Dynamic mode solves this by exposing only a small set of meta-tools that let agents progressively discover and invoke tools on demand.
+
+To enable dynamic mode, pass the `--mode dynamic` flag when starting your server:
+
+```jsonc
+{
+  "mcpServers": {
+    "Steuerboard": {
+      "command": "npx",
+      "args": ["@steuerboard/mcp", "start", "--mode", "dynamic"],
+      // ... other server arguments
+    }
+  }
+}
+```
+
+In dynamic mode, the server registers only the following meta-tools instead of every individual tool:
+
+- **`list_tools`**: Lists all available tools with their names and descriptions.
+- **`describe_tool_input`**: Returns the input schema for one or more tools by name.
+- **`execute_tool`**: Executes a tool by name with its arguments.
+
+This approach significantly reduces the number of tokens sent to the LLM on each request, which is especially useful for servers with a large number of tools.
+<!-- End Progressive Discovery [dynamic-mode] -->
+
 <!-- Placeholder for Future Speakeasy SDK Sections -->
 
 ## Development

package/_speakeasy/.github/action-inputs-config.json

@@ -0,0 +1,57 @@
+[
+  {
+    "name": "mode",
+    "validation_regex": "/^(direct|pr)$/.source",
+    "validation_message": "Must be `direct` or `pr`"
+  },
+  {
+    "name": "speakeasy_version",
+    "validation_regex": "/^[\\w.\\-]+$/.source",
+    "validation_message": "Letters, numbers, or .-_ only"
+  },
+  {
+    "name": "openapi_doc_location",
+    "validation_regex": "/^((https?):\\/\\/([\\w\\-]+\\.)+\\w+(\\/.*)?|[\\w.\\-\\/]+)$/i.source",
+    "validation_message": "Must be a valid server URL or file path containing letters, numbers, or .-_/ only"
+  },
+  {
+    "name": "openapi_doc_auth_header",
+    "validation_regex": "/^[A-Za-z\\-]+$/.source",
+    "validation_message": "Letters or - only"
+  },
+  {
+    "name": "create_release"
+  },
+  {
+    "name": "publish_python",
+    "language": "python"
+  },
+  {
+    "name": "publish_typescript",
+    "language": "typescript"
+  },
+  {
+    "name": "publish_java",
+    "language": "java"
+  },
+  {
+    "name": "publish_php",
+    "language": "php"
+  },
+  {
+    "name": "publish_ruby",
+    "language": "ruby"
+  },
+  {
+    "name": "publish_csharp",
+    "language": "csharp"
+  },
+  {
+    "name": "publish_terraform",
+    "language": "terraform"
+  },
+  {
+    "name": "publish_cli",
+    "language": "cli"
+  }
+]

package/_speakeasy/.github/action-security-config.json

@@ -0,0 +1,88 @@
+[
+  {
+    "name": "pypi_token",
+    "secret_name": "PYPI_TOKEN",
+    "validation_regex": "/^[\\w.\\-]+$/.source",
+    "validation_message": "Letters, numbers, or .-_ only",
+    "language": "python"
+  },
+  {
+    "name": "npm_token",
+    "secret_name": "NPM_TOKEN",
+    "validation_regex": "/^[\\w.\\-]+$/.source",
+    "validation_message": "Letters, numbers, or .-_ only",
+    "language": "typescript"
+  },
+  {
+    "name": "packagist_username",
+    "validation_regex": "/^[\\w.\\-]+$/.source",
+    "validation_message": "Letters, numbers, or .-_ only",
+    "language": "php"
+  },
+  {
+    "name": "packagist_token",
+    "validation_regex": "/^[\\w.\\-]+$/.source",
+    "validation_message": "Letters, numbers, or .-_ only",
+    "language": "php"
+  },
+  {
+    "name": "openapi_doc_auth_token",
+    "secret_name": "SPEC_TOKEN",
+    "validation_regex": "/^[\\w.\\-]+$/.source",
+    "validation_message": "Letters, numbers, or .-_ only"
+  },
+  {
+    "name": "speakeasy_api_key",
+    "secret_name": "SPEAKEASY_API_KEY",
+    "validation_regex": "/^[\\w.\\-]+$/.source",
+    "validation_message": "Letters, numbers, or .-_ only"
+  },
+  {
+    "name": "ossrh_username",
+    "secret_name": "MAVEN_USERNAME",
+    "validation_regex": "/^[\\w.\\-]+$/.source",
+    "validation_message": "Letters, numbers, or .-_ only",
+    "language": "java"
+  },
+  {
+    "name": "ossrh_password",
+    "secret_name": "MAVEN_PASSWORD",
+    "language": "java"
+  },
+  {
+    "name": "java_gpg_secret_key",
+    "validation_regex": "/^[\\w.\\-\\t \\r\\n]+$/.source",
+    "validation_message": "Letters, numbers, tabs, spaces, newlines, or .-_ only",
+    "language": "java"
+  },
+  {
+    "name": "java_gpg_passphrase",
+    "language": "java"
+  },
+  {
+    "name": "terraform_gpg_secret_key",
+    "secret_name": "TERRAFORM_GPG_SECRET_KEY",
+    "validation_regex": "/^[\\w.\\-\\t \\r\\n]+$/.source",
+    "validation_message": "Letters, numbers, tabs, spaces, newlines, or .-_ only",
+    "language": "terraform"
+  },
+  {
+    "name": "terraform_gpg_passphrase",
+    "secret_name": "TERRAFORM_GPG_PASSPHRASE",
+    "language": "terraform"
+  },
+  {
+    "name": "rubygems_auth_token",
+    "secret_name": "RUBYGEMS_AUTH_TOKEN",
+    "language": "ruby"
+  },
+  {
+    "name": "nuget_api_key",
+    "secret_name": "NUGET_API_KEY",
+    "language": "csharp"
+  },
+  {
+    "name": "slack_webhook_url",
+    "secret_name": "SLACK_WEBHOOK_URL"
+  }
+]