thales-cdsp-csm-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@thales-cdsp-csm-mcp-server migrate hardcoded secrets from my Flask app"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Thales CSM MCP Server
Simple MCP server for Thales CipherTrust Secrets Management, powered by Akeyless.
🎬 Demo Videos
📹 Part I: Usage & Functionality - Watch on YouTube
This video demonstrates:
Setting up Cursor AI integration
Creating and managing secrets and DFC Keys through AI chat
Security compliance workflows
Example prompts and functionality
📹 Part II: Deployment & Installation - Watch on YouTube
This video covers:
Step-by-step installation process
Configuration and setup
Deployment options
Related MCP server: @1claw/mcp
🎯 Key Features
Intelligent App Development & Security Migration
The server includes a powerful prompt that automatically determines whether you want to:
Create a NEW app with built-in CipherTrust integration
Secure an EXISTING app by migrating hardcoded secrets to CipherTrust
For New Apps:
Generates complete Python implementations with CipherTrust integration
Uses the
get_api_referencetool for native API integrationProvides production-ready code with proper error handling
For Existing Apps:
Scans codebase for hardcoded secrets using intelligent detection
Categorizes secrets by type (key-value pairs vs standalone)
Uses
manage_secretsMCP tool to create CipherTrust secretsGenerates migration reports and updated code
Provides testing and validation instructions
Secret Type Classification:
Key-Value Pairs/JSON format: AWS credentials, database configs, OAuth tokens
Standalone Secrets (Text format): Single passwords, individual tokens, certificates
📋 Prerequisites
Before you begin, ensure you have the following installed on your system:
Python 3.8+: Required for running the MCP server
uv: Modern Python package manager (recommended) or pip
git: For cloning the repository
dotenv: Environment variable management
fastmcp: MCP server framework
Thales CipherTrust Manager access
Valid Akeyless credentials
Installing Prerequisites
Python
# Check if Python is installed
python --version
# or
python3 --version
# Install Python (Ubuntu/Debian)
sudo apt update && sudo apt install python3 python3-pip
# Install Python (macOS)
brew install python
# Install Python (Windows)
# Download from https://python.orguv (Recommended)
# Install uv
pip install uv
# Verify installation
uv --versiongit
# Check if git is installed
git --version
# Install git (Ubuntu/Debian)
sudo apt update && sudo apt install git
# Install git (macOS)
brew install git
# Install git (Windows)
# Download from https://git-scm.comdotenv
# Check if python-dotenv is installed
python -c "import dotenv; print('dotenv available')"
# Install python-dotenv
pip install python-dotenv
# Verify installation
python -c "import dotenv; print(f'dotenv version: {dotenv.__version__}')"fastmcp
# Check if fastmcp is installed
python -c "import fastmcp; print('fastmcp available')"
# Install fastmcp
pip install fastmcp
# Verify installation
python -c "import fastmcp; print(f'fastmcp version: {fastmcp.__version__}')"🚀 What this MCP server features
Secrets Management: Create, read, update, delete secrets
DFC Key Management: DFC encryption keys (AES, RSA)
Account Management: Get Akeyless account details
Analytics: Fetch analytics data
Authentication Methods: Manage Authentication Methods
App Development & Security: Intelligent app creation and secret migration
Roles: Manage Roles
Targets: Manage Targets
Security: Guidelines and best practices
MCP Protocol: Model Context Protocol compliance
⚡ Quick Start
1. Install
Option A: Using pip (Traditional)
git clone https://github.com/sanyambassi/thales-cdsp-csm-mcp-server
cd thales-cdsp-csm-mcp-server
pip install -r requirements.txtOption B: Using uv (Recommended)
# Install uv if you don't have it
pip install uv
# Clone and setup
git clone https://github.com/sanyambassi/thales-cdsp-csm-mcp-server
cd thales-cdsp-csm-mcp-server
# Install dependencies (creates .venv automatically)
uv sync2. Configure
Create .env file:
AKEYLESS_ACCESS_ID=your_access_id
AKEYLESS_ACCESS_KEY=your_access_key
AKEYLESS_API_URL=https://your-ciphertrust-manager/akeyless-api/v2
LOG_LEVEL=INFO
AKEYLESS_VERIFY_SSL=false3. Run
Using pip (Traditional)
# stdio mode
python main.py
# HTTP mode
python main.py --transport streamable-http --host localhost --port 8000Using uv (Recommended)
# stdio mode
uv run python main.py
# HTTP mode
uv run python main.py --transport streamable-http --host localhost --port 8000🛠️ Available Tools
Tool | Description |
| Create static secrets, get static secret values, update, delete secrets (static, dynamic, rotated) with type filtering and dynamic secret creation |
| Manage encryption keys |
| Authentication and access control |
| Secret rotation policies |
| Enhanced security features |
| Security best practices |
| List and get role information |
| List, get, and create targets |
| Get analytics and monitoring data |
| Get account settings and licensing |
| Get API reference for native Akeyless integrations (generic workflows + S3 example) |
🔍 Test It
# Run tests
python tests/run_tests.py
python.exe tests\test_mcp_protocol.py
# Test health endpoint (HTTP mode)
curl http://localhost:8000/health📚 Documentation
TRANSPORT_MODES.md - How to run
TOOLS.md - What tools do
TESTING.md - Complete testing guide
AI Assistant Configs - MCP json examples for AI Assistants
🎯 Use Cases
AI Assistants: Claude Desktop, Cursor AI
Web Applications: REST API integration
Automation: CI/CD, scripts, tools
Enterprise: Secrets management, compliance
🤖 AI Assistant Integration
Claude Desktop
{
"mcpServers": {
"thales-csm": {
"command": "python",
"args": ["main.py", "--transport", "stdio"],
"env": {
"AKEYLESS_ACCESS_ID": "your_access_id_here",
"AKEYLESS_ACCESS_KEY": "your_access_key_here",
"AKEYLESS_API_URL": "https://your-ciphertrust-manager/akeyless-api/v2",
"LOG_LEVEL": "INFO"
}
}
}
}Cursor AI
{
"mcpServers": {
"thales-csm": {
"command": "python",
"args": ["main.py", "--transport", "stdio"],
"env": {
"AKEYLESS_ACCESS_ID": "your_access_id_here",
"AKEYLESS_ACCESS_KEY": "your_access_key_here",
"AKEYLESS_API_URL": "https://your-ciphertrust-manager/akeyless-api/v2",
"LOG_LEVEL": "INFO"
}
}
}
}Configuration Parameters
env: Environment variables for Akeyless authentication and loggingcommand: Python executable to run the serverargs: Command line arguments for the server
⚠️ Important Notes
Full Path Required:
argsmust include the full absolute path tomain.pyWindows Paths: Use double backslashes
\\in Windows paths (e.g.,C:\\thales-cdsp-csm-mcp-server\\main.py)Unix Paths: Use forward slashes
/in Unix/Linux paths (e.g.,/home/user/thales-cdsp-csm-mcp-server/main.py)
Configuration Templates
config/mcp-config-uv.json - UV package manager setup
config/mcp-config.json - Basic configuration template
🤝 Support
Issues: GitHub Issues
Documentation: Check the docs folder above
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
Available Tools
12 toolsget_api_referenceA
API REFERENCE TOOL - Generate production-ready code examples and integration patterns
SUPPORTED ENDPOINTS: • workflow: Complete integration patterns and best practices • auth: Authentication flows and token management • create-secret: Secret creation and management APIs • get-secret-value: Secret retrieval and access patterns • list-items: Item listing and discovery APIs • delete-item: Item deletion and cleanup operations • list-roles: Role management and access control • list-targets: Target management and configuration
INTEGRATION FEATURES: • Production-ready code examples with authentication • Complete error handling and retry logic • Best practices for secure integration patterns • Multi-language support (Python, JavaScript, etc.) • Token management and session handling
USE CASES: • Building custom applications and integrations • CI/CD pipeline integration and automation • Microservice authentication and configuration • Native client development and SDK creation • Production system integration and deployment
Example: Generate complete Python client code for secret management
Inputs: api_endpoint (required), language, include_auth, include_error_handling. Returns: object
manage_accountA
ACCOUNT ADMINISTRATION TOOL - Manage organizational settings and governance
SUPPORTED ACTIONS: • get: Retrieve complete account configuration, licensing details, and system-wide policies
ACCOUNT INFORMATION PROVIDED: • Organizational details and company profile • Licensing and subscription tier information • Service tier, SLA level, and feature availability • Usage quotas, capacity limits, and billing details • System configuration and security policies • Governance, compliance, and audit settings • Multi-tenant configuration and access controls
USE CASES: • Account setup and initial configuration • Compliance and audit preparation • License management and planning • Security policy review and updates • Service tier evaluation and upgrades • Multi-tenant administration
Example: Review account licensing and compliance configuration
Inputs: action (required), json, uid_token. Returns: object
manage_analyticsA
ANALYTICS & MONITORING TOOL - Comprehensive infrastructure monitoring and reporting
SUPPORTED ACTIONS: • get: Retrieve comprehensive monitoring data, usage statistics, and performance metrics
ANALYTICS COVERAGE: • Usage statistics and item counts by type (Secrets, Targets, Roles, Keys) • Geographic distribution of access requests and client patterns • Security risk analysis and certificate expiry tracking • Authentication method usage and access control compliance • Multi-region usage distribution and product-specific metrics • Resource utilization, capacity planning, and audit summaries
FILTERING OPTIONS: • Filter by item type (Targets, Static Secrets, Dynamic Secrets, DFC Keys, etc.) • Filter by risk level (Expired, Healthy, Expiring Soon certificates) • Filter by product component (Secrets Management, Advanced Data Protection, etc.)
USE CASES: • Security operations center (SOC) dashboards • Compliance reporting and audit preparation • Capacity planning and resource optimization • Risk assessment and vulnerability management • Executive reporting and KPI tracking
Example: Get security risk analysis for certificate expiry management
Inputs: action (required), json, uid_token, filter_by_risk, +2 more. Returns: object
manage_auth_methodsA
AUTHENTICATION METHODS MANAGEMENT TOOL - Create, manage, and secure authentication methods
SUPPORTED ACTIONS: • create_api_key: Create API key authentication methods with IP restrictions and expiration • create_email: Create email-based authentication methods with MFA support • list: List all authentication methods with filtering and pagination • get: Retrieve detailed authentication method configuration and status • update: Modify authentication method properties, credentials, and settings • delete: Delete individual authentication methods with proper cleanup • delete_auth_methods: Bulk delete authentication methods within a specific path
SECURITY FEATURES: • IP address restrictions and CIDR whitelisting • Access expiration and JWT TTL management • Multi-factor authentication (MFA) support • Audit logging and compliance tracking • Delete protection and access control
Example: Create a secure API key for application authentication
Inputs: action (required), json, name, path, +19 more. Returns: object
manage_customer_fragmentsA
CUSTOMER FRAGMENT MANAGEMENT TOOL - Manage customer fragment encryption and security
SUPPORTED ACTIONS: • list: List customer fragments with path filtering and pattern matching • export: Export customer fragments with optional JSON format • download: Download customer fragments (alias for export action)
SECURITY FEATURES: • Customer fragment encryption for enhanced security • Access control and audit trails • Enterprise-grade fragment management • Compliance and security reporting
USE CASES: • Customer fragment inventory and management • Security compliance and audit preparation • Fragment backup and export operations • Enhanced encryption key management
Example: List and export customer fragments for security audit
Inputs: action (required), json, path, filter_by. Returns: object
manage_dfc_keysA
DFC KEY MANAGEMENT TOOL - Advanced encryption key management and lifecycle
SUPPORTED ACTIONS: • create: Create new DFC keys with encryption algorithms (AES128GCM, AES256GCM, RSA2048, etc.) • update: Modify DFC key properties, tags, and metadata • delete: Delete DFC keys with proper cleanup • list: List DFC keys in directory with filtering • set_state: Enable/disable DFC keys for access control • rotate: Rotate DFC keys on demand with new certificates and key data
ADVANCED FEATURES: • Auto-rotation with configurable intervals (7-365 days) • Customer fragment encryption for enhanced security • Self-signed certificate generation with X.509 support • Split levels (3 or 4 fragments) for key distribution • Expiration and rotation event notifications • Comprehensive metadata and configuration support
SECURITY CAPABILITIES: • Enterprise-grade key management with audit trails • Access control and delete protection • Customer fragment integration • Certificate lifecycle management • Compliance and governance reporting
Example: Create an AES256GCM DFC key with auto-rotation for application encryption
Inputs: action (required), json, name, path, +33 more. Returns: object
manage_gatewaysB
GATEWAY MANAGEMENT TOOL - Monitor and manage gateway infrastructure
SUPPORTED ACTIONS: • list: List available gateways with detailed information and filtering
GATEWAY INFORMATION PROVIDED: • Gateway configuration and status • Connection details and endpoints • Performance metrics and health status • Access control and security settings • Integration and routing information
USE CASES: • Gateway infrastructure monitoring • Connection troubleshooting and diagnostics • Performance analysis and optimization • Security configuration review • Gateway inventory and management
Example: List all gateways to monitor infrastructure health
Inputs: action (required), json, path, filter_by. Returns: object
manage_rolesA
ROLE MANAGEMENT TOOL - Discover and analyze role-based access control
SUPPORTED ACTIONS: • list: Discover all roles with advanced filtering and pagination • get: Retrieve comprehensive role details including permissions, access rules, and policies
ROLE INFORMATION PROVIDED: • Permission sets and access rules • Associated policies and restrictions • User/group assignments and mappings • Resource access configurations • Audit and compliance information
USE CASES: • Security audits and compliance reporting • Access permission troubleshooting • Role-based access control planning • Identity and access management (IAM) integration • Permission inheritance analysis
Example: Check what permissions the 'database-admin' role has
Inputs: action (required), json, name, filter, +2 more. Returns: object
manage_rotation_settingsC
ROTATION SETTINGS MANAGEMENT TOOL - Automate secret and key rotation for security compliance
SUPPORTED ACTIONS: • set_rotation: Set rotation settings for secrets and keys with scheduling • update_settings: Update existing rotation configurations and parameters • list_rotation: List items with rotation settings and status • get_rotation_status: Get detailed rotation status and history information
ROTATION FEATURES: • Auto-rotation with configurable intervals (7-365 days) • Rotation event notifications and scheduling • Advanced rotation windows and cron-based scheduling • Rotate after disconnect settings for security • Comprehensive rotation status tracking and reporting
SECURITY BENEFITS: • Automated security through intelligent rotation scheduling • Enterprise-grade rotation with access control and audit trails • Compliance with security policies and regulations • Reduced manual intervention and human error • Proactive security through regular credential updates
Example: Set up automated rotation for database credentials every 30 days
Inputs: action (required), json, path, filter_by, +7 more. Returns: object
manage_secretsB
SECRETS MANAGEMENT TOOL - Create, retrieve, update, and delete secrets
SUPPORTED ACTIONS:
• create_static_secret: Create text/JSON secrets with metadata
• get_static_secret_value: Retrieve secret values securely
• update: Modify secret properties and values
• delete: Delete individual secrets (smart detection)
• delete_items: Bulk delete multiple secrets or directories
• list: List secrets in directory with type filtering
• list_dynamic_secrets: List all dynamic secrets globally
• create_dynamic_secret_ldap: Create LDAP dynamic secrets
• create_dynamic_secret_mysql: Create MySQL dynamic secrets
• create_dynamic_secret_mongodb: Create MongoDB dynamic secrets
• list_shared_items: List shared secrets and items
DELETE OPERATIONS: • Individual: delete(name="/secret1") • Multiple: delete_items(items=["/secret1", "/secret2"]) • Directory: delete_items(path="/directory/")
Example: Create a database password secret
Inputs: action (required), ssl, ttl, json, +72 more. Returns: object
manage_targetsB
TARGET MANAGEMENT TOOL - Manage external system connections and integrations
SUPPORTED ACTIONS: • list: Discover all configured targets with filtering • get: Retrieve detailed target configuration and credentials • create: Create new database or LDAP targets • delete: Delete individual target with version control • delete_targets: Bulk delete targets within a specific path
SUPPORTED TARGET TYPES: • Database: MySQL, PostgreSQL, MSSQL, Oracle, Snowflake, MongoDB, Cassandra, HanaDB, Redshift, Redis • LDAP: OpenLDAP, Active Directory • Cloud: AWS, Azure, GCP
Example: Create a MySQL database target for application connections
Inputs: action (required), pwd, ssl, host, +47 more. Returns: object
security_guidelinesA
SECURITY GUIDELINES TOOL - Comprehensive security guidance and compliance management
SUPPORTED ACTIONS: • get_guidelines: Get security best practices and guidelines by category • validate: Validate secrets and configurations for security compliance • audit: Perform comprehensive security audits and assessments • compliance_check: Check compliance with industry standards (SOC2, ISO27001, GDPR, HIPAA)
SECURITY CATEGORIES: • best_practices: Security best practices and recommendations • compliance: Compliance frameworks and requirements • audit: Security audit procedures and checklists • encryption: Encryption standards and key management
COMPLIANCE STANDARDS: • SOC2: Service Organization Control 2 compliance • ISO27001: Information security management systems • GDPR: General Data Protection Regulation • HIPAA: Health Insurance Portability and Accountability Act
SECURITY FEATURES: • Enterprise-grade security with access control and audit trails • Automated security validation and compliance checking • Comprehensive audit procedures and reporting • Industry-standard compliance framework support
Example: Perform security audit and compliance check for SOC2 requirements
Inputs: action (required), json, context, category, +5 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool targets a distinct resource area, from secrets and keys to account, analytics, and security guidelines. Even closely related tools like manage_secrets and manage_dfc_keys are clearly separated by their resource types and actions.
The naming is largely consistent with a 'manage_<resource>' pattern for 10 of 12 tools, but 'get_api_reference' and 'security_guidelines' deviate. This is a minor inconsistency that does not obscure the tools' purposes.
With 12 tools, the server is well-scoped for a secrets and key management platform. Each tool covers a meaningful subdomain without redundancy, fitting comfortably within the ideal 3-15 tool range.
Core lifecycle operations are covered for secrets, DFC keys, auth methods, and targets, with rotation and security guidelines included. Minor gaps exist: manage_targets lacks an update action, manage_account is read-only, and dynamic secret support covers only LDAP, MySQL, and MongoDB, but these can be worked around.
Maintenance
Related MCP Connectors
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
MCP server for Appcircle mobile CI/CD platform.
Authenticated MCP server for ClearPolicy policy and compliance workflows.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Related MCP Servers
AlicenseBqualityBmaintenanceMCP server for the Delinea Secret Server and Platform APIs, enabling AI agents to manage secrets, users, groups, folders, roles, and access requests through natural language commands.3650MIT
@1claw/mcpofficial
AlicenseAqualityBmaintenanceMCP server for secure, just-in-time secret retrieval from 1claw vault and malicious content inspection, enabling AI agents to access secrets and security analysis.1763 npm4MIT- AlicenseNot gradedqualityDmaintenanceMCP server that integrates with ARXsec.io API to execute security scans, compliance checks, secrets management, and remediation actions with policy enforcement, audit logging, and human approval workflows.MIT
- AlicenseNot gradedqualityFmaintenanceMCP server for AI-native credential management, enabling agents to securely store, retrieve, and manage API keys with encryption, spending budgets, and audit logging.MIT