Overview
Superargs is a tool that allows users to provide arguments to any Model Context Protocol (MCP) server during runtime, enhancing flexibility in server configuration.
To use Superargs, run it via npx with the desired command, replacing placeholders with actual values during runtime. For example: npx -y superargs --stdio "GITHUB_PERSONAL_ACCESS_TOKEN={{githubToken}} npx -y @modelcontextprotocol/server-github".
- Dynamic argument injection during runtime. - Customizable tool name for updating arguments. - Comprehensive support for MCP requests. - Change notifications for connected clients when args are updated.
- Configuring MCP servers dynamically during AI interactions.
- Providing sensitive information like authentication tokens securely.
- Enhancing flexibility in server management without pre-configuration.
Add to your AI client
Use these steps to connect Superargs in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"superargs-supercorp-ai": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-superargs-supercorp-ai"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"superargs-supercorp-ai": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-superargs-supercorp-ai"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"superargs-supercorp-ai": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-superargs-supercorp-ai"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"superargs-supercorp-ai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-superargs-supercorp-ai"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"superargs-supercorp-ai": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-superargs-supercorp-ai"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"superargs-supercorp-ai": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-superargs-supercorp-ai"
]
}
}
}FAQ
Can Superargs handle all types of MCP servers?
Yes! Superargs is designed to work with any MCP server that requires dynamic arguments.
Is Superargs secure for sensitive data?
Yes! Superargs does not store any args; they are passed directly to the child MCP server.