agenticwerx-mcp-client 1.0.5

Simple MCP client that connects to your AgenticWerx MCP server to retrieve rules

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 rules
uvx agenticwerx-mcp-client@latest --api-key YOUR_KEY get-rules

# 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

1. Visit AgenticWerx Dashboard
2. Navigate to API Keys section
3. Create a new API key
4. Use it in CLI or MCP configuration

🛠️ Available Tools

MCP Server Mode Tools

get_rules

Get AgenticWerx rules from the server.

Parameters:

• packageId (optional): Specific package ID to filter rules

analyze_code

Analyze code using AgenticWerx rules from the server.

Parameters:

• code (required): Code snippet to analyze
• language (optional): Programming language
• packageIds (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.

🔗 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

• Full Documentation
• API Reference
• Rule Package Catalog
• IDE Integration Guides

🆘 Support

• Documentation: docs.agenticwerx.com
• Email Support: [e-mail]
• 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.