Deprecated

⚠️ This repository is no longer maintained.

Please use the Secureframe hosted MCP server instead.

No new issues or pull requests will be accepted here.

Secureframe MCP Server

This Model Context Protocol server provides read-only access to Secureframe's compliance automation platform for AI assistants like Claude and Cursor. Query security controls, monitor compliance tests, and access audit data across SOC 2, ISO 27001, CMMC, FedRAMP, and other frameworks.

⚠️ Disclaimer: This MCP server is currently in public beta and grants AI assistants read-only access to your Secureframe compliance data. While the server only performs read operations, always review and validate AI-generated insights before making any compliance or security decisions. You are responsible for ensuring all AI outputs align with your organization's compliance policies and security standards.

🚀 Quick Start

Prerequisites

• Python 3.7 or higher
• Secureframe API credentials (Get them here)
• Claude Desktop, Cursor IDE, or any MCP-compatible tool

Installation

# Clone and setup
git clone https://github.com/secureframe/secureframe-mcp-server.git
cd secureframe-mcp-server

# Create virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Configure credentials
cp env.example .env
# Edit .env with your API credentials

🔧 Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "secureframe": {
      "command": "python",
      "args": ["/absolute/path/to/secureframe-mcp-server/main.py"],
      "env": {
        "SECUREFRAME_API_KEY": "your_api_key",
        "SECUREFRAME_API_SECRET": "your_api_secret",
        "SECUREFRAME_API_URL": "https://api.secureframe.com"
      }
    }
  }
}

Cursor IDE

Configure in Cursor's MCP settings:

{
  "mcpServers": {
    "Secureframe": {
      "command": "python",
      "args": ["/absolute/path/to/secureframe-mcp-server/main.py"],
      "env": {
        "SECUREFRAME_API_KEY": "your_api_key",
        "SECUREFRAME_API_SECRET": "your_api_secret",
        "SECUREFRAME_API_URL": "https://api.secureframe.com"
      }
    }
  }
}

Environment Variables

Regional Endpoints:

• 🇺🇸 US: https://api.secureframe.com (default)
• 🇬🇧 UK: https://api-uk.secureframe.com

📋 Available Tools (11 Read-Only Operations)

💡 Usage Examples

Monitor Failing Controls

# Find controls that need attention for SOC 2
list_controls(
    search_query="health_status:unhealthy AND frameworks:soc2_alpha",
    per_page=50
)

Find Failing Tests

# Get top 5 failing tests
list_tests(
    search_query="health_status:fail",
    per_page=5
)

Review High-Risk Vendors

# Find high-risk vendors
list_tprm_vendors(
    search_query="risk_level:High",
    per_page=20
)

Check User Compliance

# Find inactive contractors
list_users(
    search_query="employee_type:contractor AND active:false",
    per_page=100
)

🔍 Search Capabilities

The server supports powerful Lucene query syntax for filtering:

Example Queries

Find critical failing tests:

health_status:fail AND frameworks:soc2_alpha

Locate inactive users:

active:false AND employee_type:contractor

Search high-risk vendors:

risk_level:High AND archived:false

Common Search Fields

• health_status - For controls: healthy, unhealthy, draft. For tests: pass, fail, disabled
• enabled - true/false
• test_type - integration, upload

• active - true/false
• email - User email address
• employee_type - employee, contractor, non_employee, auditor, external
• in_audit_scope - true/false

• risk_level - Low, Medium, High
• status - draft, completed
• archived - true/false

• private - true/false
• in_audit_scope - true/false

🛠️ Development

Debug with MCP Inspector

npx @modelcontextprotocol/inspector python main.py

📚 Resources

• Secureframe API Documentation
• Model Context Protocol
• Parameter Reference Guide

🎯 Obtaining API Credentials

1. Log into Secureframe
2. Navigate to Profile Picture → Company Settings → API Keys
3. Click Create API Key
4. Save your credentials securely (secret shown only once)

⚖️ License

This project is licensed under the MIT License. See LICENSE for details.