AgenticWerx MCP Client
A Model Context Protocol (MCP) client that connects to the AgenticWerx Lambda MCP server using JSON-RPC 2.0 protocol to provide code analysis and rule management capabilities.
🚀 Quick Start
The AgenticWerx MCP Client supports two modes:
CLI Mode - Direct Command Line Usage
# Get marketplace rules
uvx agenticwerx-mcp-client@latest --api-key YOUR_KEY get-rules
# Get custom rules (Pro/Pro Plus)
uvx agenticwerx-mcp-client@latest --api-key YOUR_KEY get-custom-rules --language python
# Get team rules (Pro Plus teams)
uvx agenticwerx-mcp-client@latest --api-key YOUR_KEY get-team-rules --category security
# Analyze code
uvx agenticwerx-mcp-client@latest --api-key YOUR_KEY analyze-code --file script.py
# Analyze code snippet
uvx agenticwerx-mcp-client@latest --api-key YOUR_KEY analyze-code \
--code "print('hello')" --language python
Features:
- 🔍 Auto-detects programming language from file extensions
- 📦 Automatically chunks large files (>8KB) for analysis
- 📊 Aggregates results from multiple chunks
- 🎯 Supports 20+ programming languages
See CLI_USAGE.md for detailed CLI documentation.
MCP Server Mode - For IDE Integration
Add this configuration to your MCP-compatible IDE (Kiro, Amazon Q Developer, etc.):
{
"mcpServers": {
"agenticwerx": {
"command": "uvx",
"args": ["agenticwerx-mcp-client@latest"],
"env": {
"AGENTICWERX_API_KEY": "your-api-key-here"
}
}
}
}
Get Your API Key
- Visit AgenticWerx Dashboard
- Navigate to API Keys section
- Create a new API key
- Use it in CLI or MCP configuration
🛠️ Available Tools
MCP Server Mode Tools
get_rules
Get AgenticWerx marketplace rules from subscribed packages.
Parameters:
packageId(optional): Specific package ID to filter ruleslanguage(optional): Filter by programming language (e.g., typescript, python, go)framework(optional): Filter by framework (e.g., react, nextjs, express)category(optional): Filter by category (e.g., security, api-design, testing)severity(optional): Filter by severity (critical, high, medium, low)appliesTo(optional): Filter by applies to (e.g., frontend, backend, api, all)search(optional): Search in rule titles and descriptionsruleIds(optional): Get specific rules by IDdetailed(optional): Get full rule details (instructions, rationale, tags). Default: falseincludeContent(optional): Get complete rule content (markdown/JSON). Default: falseincludePatterns(optional): Include regex patterns (requires detailed=true). Default: falselimit(optional): Maximum rules to return (1-200). Default: 50offset(optional): Skip N rules for pagination. Default: 0
get_custom_rules
Get user-uploaded custom rules (Pro/Pro Plus only).
Custom rules are rules you've uploaded to your AgenticWerx account. These are private to your account and can be used alongside marketplace rules.
Parameters:
Same filtering options as get_rules (except packageId):
language,framework,category,severity,appliesTo,search,ruleIdsdetailed,includeContent,includePatternslimit,offset
get_team_rules
Get team-shared custom rules (Pro Plus teams only).
Team rules are custom rules shared across your Pro Plus team. These are visible to all team members and can be used alongside marketplace and custom rules.
Parameters:
Same filtering options as get_rules (except packageId):
language,framework,category,severity,appliesTo,search,ruleIdsdetailed,includeContent,includePatternslimit,offset
analyze_code
Analyze code using AgenticWerx rules from the server.
Parameters:
code(required): Code snippet to analyzelanguage(optional): Programming languagepackageIds(optional): Array of package IDs to use for analysis
Example:
{
"tool": "analyze_code",
"code": "print('hello world')",
"language": "python",
"packageIds": ["stripe-integration-excellence-pack"]
}
The tool connects to AgenticWerx services and retrieves the rules, which are then processed and returned to your IDE.
External MCP Server Tools 🆕
Connect to external MCP servers (GitHub, AWS Docs, PostgreSQL, etc.) alongside AgenticWerx rules.
list_external_mcp_servers
Discover available external MCP servers from the AgenticWerx registry.
Parameters: None
Returns: List of pre-configured servers (GitHub, AWS Docs, PostgreSQL, etc.)
get_external_mcp_server
Get connection details for a specific external MCP server.
Parameters:
serverId(required): Server ID from registry (e.g., "github", "aws-documentation")
Returns: Command, arguments, and required environment variables
connect_external_server
Connect to an external MCP server. Supports two modes:
Mode A - Using serverId (Recommended):
{
"serverId": "github",
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx"
}
}
Mode B - Manual Connection:
{
"name": "custom-server",
"command": "python",
"args": ["my_server.py"],
"env": {
"CUSTOM_VAR": "value"
}
}
Features:
- ✅ Automatic persistence - connections restored on restart
- ✅ Multiple simultaneous connections
- ✅ Tool discovery and execution
- ✅ Support for custom servers
list_external_connections
List all currently connected external MCP servers and their available tools.
disconnect_external_server
Disconnect from an external MCP server.
Parameters:
serverName(required): Name of the server to disconnect
call_external_tool
Call a tool on a connected external MCP server.
Parameters:
serverName(required): Name of the connected servertoolName(required): Name of the tool to callarguments(optional): Arguments to pass to the tool
See EXTERNAL_MCP_SERVERS.md for detailed documentation.
🔗 Simple Connection
This client acts as a simple bridge between your IDE and AgenticWerx services. It retrieves rules and passes them back to your IDE for code analysis.
🔧 Installation Methods
Method 1: UVX (Recommended)
No installation needed! Your IDE will automatically download and run the client:
uvx agenticwerx-mcp-client@latest --api-key your_key_here
Method 2: pip install
pip install agenticwerx-mcp-client
agenticwerx-mcp-client --api-key your_key_here
Method 3: From Source
git clone https://github.com/agenticwerx/mcp-client.git
cd mcp-client
pip install -e .
agenticwerx-mcp-client --api-key your_key_here
📋 IDE Configuration Examples
Kiro IDE
{
"mcpServers": {
"agenticwerx": {
"command": "uvx",
"args": ["agenticwerx-mcp-client@latest", "--api-key", "${AGENTICWERX_API_KEY}"],
"env": {
"AGENTICWERX_API_KEY": "your-api-key-here"
}
}
}
}
Amazon Q Developer
{
"mcpServers": {
"agenticwerx": {
"command": "uvx",
"args": ["agenticwerx-mcp-client@latest", "--api-key", "${AGENTICWERX_API_KEY}"],
"env": {
"AGENTICWERX_API_KEY": "your-api-key-here"
}
}
}
}
VS Code (with MCP extension)
{
"mcp.servers": {
"agenticwerx": {
"command": "uvx",
"args": ["agenticwerx-mcp-client@latest", "--api-key", "${AGENTICWERX_API_KEY}"],
"env": {
"AGENTICWERX_API_KEY": "your-api-key-here"
}
}
}
}
🔒 Security & Privacy
- API Key Security: Your API key is only used to authenticate with AgenticWerx services
- Code Privacy: Code analysis happens securely through encrypted connections
- No Data Storage: Your code is analyzed in real-time and not stored on our servers
- Local Processing: The MCP client runs locally on your machine
🚀 Features
- ✅ Simple Connection: Connects your IDE to AgenticWerx services
- ✅ Rule Retrieval: Fetches rules from the server
- ✅ MCP Compatible: Works with any MCP-compatible IDE
- ✅ Zero Configuration: Just add your API key
- ✅ Lightweight: Minimal overhead, just passes data through
📊 Example Output
{
"tool": "analyze",
"packageId": "stripe-integration-excellence-pack",
"rules": {
"rules": [
{
"id": "rule-1",
"name": "Security Rule",
"description": "Prevents security vulnerabilities",
"pattern": "eval\\(",
"message": "Avoid using eval() as it can lead to code injection"
}
],
"metadata": {
"package_name": "Security Rules",
"version": "1.0.0",
"total_rules": 1
}
}
}
🛠️ Technical Requirements
Runtime Requirements
- Python 3.8+
- httpx >= 0.25.0
- mcp >= 1.0.0
- pydantic >= 2.0.0
Installation
# Via uvx (recommended)
uvx agenticwerx-mcp-client@latest --api-key your_key_here
# Via pip
pip install agenticwerx-mcp-client
📚 Documentation
🆘 Support
- Documentation: docs.agenticwerx.com
- Email Support: support@agenticwerx.com
- Community: Discord Server
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
Note: This is a proprietary package developed and maintained exclusively by AgenticWerx. We do not accept external contributions at this time.
🔄 Changelog
v1.0.0 (2025-01-XX)
- Initial release
- Full MCP protocol support
- Rule retrieval tools
- Multi-language support
- Real-time code feedback
Built with ❤️ by the AgenticWerx Team
Making code quality accessible to every developer, in every IDE, for every language.
Metadata
Release files for agenticwerx-mcp-client 1.5.19
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agenticwerx_mcp_client-1.5.19.tar.gz | 46.8 kB | Without provenance | Details for agenticwerx_mcp_client-1.5.19.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agenticwerx_mcp_client-1.5.19-py3-none-any.whl | Python 3 | none | any | Details for agenticwerx_mcp_client-1.5.19-py3-none-any.whl |
Total release size: 102.1 kB
Release files / agenticwerx_mcp_client-1.5.19.tar.gz
| Download URL | agenticwerx_mcp_client-1.5.19.tar.gz |
|---|---|
| Size | 46.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
619f7db66db62cbfa85860c7bd355a61ebf160bcfed15c631bc78cca8dd08140
|
|
BLAKE2b-256 checksum How to use checksums |
2cde871c784487cf46bdc0db2e036f1e462f093ae349bb74e160b7eb200fd5b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / agenticwerx_mcp_client-1.5.19-py3-none-any.whl
| Download URL | agenticwerx_mcp_client-1.5.19-py3-none-any.whl |
|---|---|
| Size | 55.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3e312a34e508161876dee7972e15c237b9d5a8e1d8838108302faac9b4e9b899
|
|
BLAKE2b-256 checksum How to use checksums |
cd05eb5ec119faca1855400c9a9aff06fe9a35b24d93b8af04b0646fd9a1b9d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Security for agenticwerx-mcp-client 1.5.19
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.