Superargs
by supercorp-ai
Superargs allows setting up MCP server args during runtime, providing arguments to any MCP server during interaction with an assistant instead of during initial setup. It makes it easy to provide authentication tokens, environment variables, or other CLI arguments during runtime.
Last updated: N/A
What is Superargs?
Superargs is a middleware wrapper around your MCP server that enables dynamic injection of arguments at runtime. It forwards all MCP requests to the underlying child server and introduces an additional tool to manage these arguments.
How to use Superargs?
Superargs is used via npx. You specify the command to run your MCP server with placeholders for arguments (e.g., {{argName}}). These placeholders can then be populated at runtime using the update_args tool. You can also customize the name of the update tool using the --update-args-tool-name flag.
Key features of Superargs
Dynamic Arg Injection: Replace placeholders in your MCP server command with actual values during runtime.
Customizable Tool Name: Rename the arg update tool via
--update-args-tool-nameto suit your workflow.Comprehensive MCP Support: Forwards all MCP requests to the child server, including tools, prompts, resources, messages, and roots.
Change Notifications: Sends notifications like
sendToolListChanged,sendPromptListChanged, andsendResourceUpdatedwhen args are updated, ensuring connected clients are aware of changes.
Use cases of Superargs
Dynamically configure MCP servers during interactions with AI assistants.
Provide necessary arguments and credentials on-the-fly through conversation.
Enable flexible deployments and remote access to MCP servers.
Facilitate easier debugging of MCP server configurations.
FAQ from Superargs
How are sensitive arguments handled?
How are sensitive arguments handled?
Arguments are passed to the child MCP server in the command specified. Nothing is stored. For maximum security, call the MCP server directly through a server client instead of through the assistant.
What if the server requires args to start?
What if the server requires args to start?
If the server requires args to start, it will not start until the args are set and it will only have the update_args tool. All other MCP server functions will either return an empty list or an error message.
What happens when update_args is used?
What happens when update_args is used?
The server will restart with the new args and all MCP server functions will be available.
What is the default name of the tool to update arguments?
What is the default name of the tool to update arguments?
By default, the tool is named update_args.
What is Model Context Protocol (MCP)?
What is Model Context Protocol (MCP)?
Model Context Protocol standardizes how AI tools exchange data. Superargs allows you to provide dynamic arguments to MCP servers at runtime without altering the server's code, enabling flexible deployments, remote access, and easier debugging.