Vanta MCP Server

A Model Context Protocol server that provides access to Vanta's automated security compliance platform. Vanta helps organizations achieve and maintain compliance with security frameworks like SOC 2, ISO 27001, HIPAA, GDPR, and others through automated monitoring, evidence collection, and continuous security testing. This MCP server enables AI assistants to interact with Vanta's API to retrieve compliance test results, manage security findings, and access framework requirements.

⚠️ Important Disclaimer: This experimental server is currently in public preview and provides AI assistants with access to your Vanta compliance data. You may encounter bugs, errors or unexpected results. Always verify the accuracy and appropriateness of AI-generated responses before taking any compliance or security actions. Users are responsible for reviewing all outputs and ensuring they meet their organization's security and compliance requirements.

Features

Controls

• List security controls or fetch a specific control by ID
• Discover which automated tests validate each control
• Review evidence documents mapped to controls

Tool Name	Description
controls	Access security controls in your Vanta account. Provide controlId to get a specific control, or omit to list all controls with optional framework filtering.
list_control_tests	Enumerate automated tests that validate a specific security control, including status and failing entity details.
list_control_documents	List documents that provide evidence for a specific security control so you can quickly locate supporting artifacts.

Documents

• Enumerate compliance documents across your organization
• Inspect the controls, links, or uploads associated with a document

Tool Name	Description
documents	List documents in your Vanta account or retrieve a specific document by ID with metadata for compliance and evidence management.
document_resources	Retrieve resources linked to a document (controls, links, uploads) by specifying the desired resource type.

Frameworks

• Review framework adoption and progress metrics across your organization
• Drill into the controls required by each framework

Tool Name	Description
frameworks	List compliance frameworks available in your Vanta account along with completion status and progress metrics.
list_framework_controls	Retrieve the controls associated with a framework, including descriptions, implementation guidance, and current compliance status.

Integrations

• Enumerate connected integrations and review their metadata
• Explore supported resource kinds and fetch integration resources on demand

Tool Name	Description
integrations	List integrations connected to your Vanta account or fetch details for a specific integration, including supported resource kinds and connection status.
integration_resources	Access integration resources by selecting the desired operation (list_kinds, get_kind_details, list_resources, or get_resource).

People

• List or retrieve people for compliance and access reviews

Tool Name	Description
people	List people in your Vanta account or retrieve a specific person by ID, including role, email, and group membership metadata.

Risks

• Track risk scenarios, their status, scoring, and treatment plans

Tool Name	Description
risks	List risk scenarios managed in your risk register or fetch a specific scenario by ID to review status, scoring, and treatment information.

Tests

• Monitor automated security tests running in your environment
• Investigate the entities associated with a specific test

Tool Name	Description
tests	Retrieve Vanta's automated security and compliance tests. Filter by status, integration, or framework to understand which controls are passing or failing.
list_test_entities	Get the resources monitored by a specific security test, including failing entities that require remediation.

Vulnerabilities

• Review vulnerabilities surfaced by Vanta, including CVE metadata and affected assets

Tool Name	Description
vulnerabilities	List vulnerabilities detected across your infrastructure or retrieve a specific vulnerability by ID with CVE details, severity, and impacted asset information.

Multi-Region Support

• US, EU, and AUS regions with region-specific API endpoints
• Global compliance support for distributed organizations

Tools

Tool Name	Description
tests	Retrieve Vanta's automated security and compliance tests. Filter by status, integration, or framework to understand pass/fail posture quickly.
list_test_entities	Get resources monitored by a particular test, including failing entities that need remediation.
controls	List security controls in your Vanta account or retrieve a specific control by ID with framework mapping details.
list_control_tests	Enumerate automated tests that validate a specific control, complete with status and failing entity information.
list_control_documents	List documents mapped to a control to locate supporting evidence quickly.
documents	List compliance documents or fetch details for a specific document, including metadata.
document_resources	Retrieve resources linked to a document (controls, links, uploads) by choosing the desired resource type.
integrations	List integrations connected to your Vanta account or fetch details for a specific integration, including resource kinds and connection status.
integration_resources	Inspect integration resource kinds, schema information, full resource lists, or a specific resource by selecting from the supported operations.
frameworks	List compliance frameworks with completion status and progress metrics for each.
list_framework_controls	Retrieve the controls associated with a compliance framework, including descriptions and implementation guidance.
people	List people across your organization or look up a specific person by ID with role, email, and group membership metadata.
risks	List risk scenarios under management or fetch a specific scenario to review status, scoring, and treatment plans.
vulnerabilities	List detected vulnerabilities or retrieve a specific item with CVE metadata, severity, and impacted assets.

Configuration

Vanta OAuth Credentials

1. Create OAuth credentials from Vanta's developer dashboard
2. Save the client_id and client_secret to an env file:

   {
     "client_id": "your_client_id_here",
     "client_secret": "your_client_secret_here"
   }
   

Note: Vanta currently allows only a single active access_token per Application. More info here

Usage with Claude Desktop

Add the server to your claude_desktop_config.json:

{
  "mcpServers": {
    "vanta": {
      "command": "npx",
      "args": ["-y", "@vantasdk/vanta-mcp-server"],
      "env": {
        "VANTA_ENV_FILE": "/absolute/path/to/your/vanta-credentials.env"
      }
    }
  }
}

If you are unfamiliar with setting up MCP servers in Claude Desktop, here is an example in the official MCP documentation.

Usage with Cursor

Add the server to your Cursor MCP settings:

{
  "mcpServers": {
    "Vanta": {
      "command": "npx",
      "args": ["-y", "@vantasdk/vanta-mcp-server"],
      "env": {
        "VANTA_ENV_FILE": "/absolute/path/to/your/vanta-credentials.env"
      }
    }
  }
}

Environment Variables

• VANTA_ENV_FILE (required): Absolute path to the JSON file containing your OAuth credentials
• REGION (optional): API region - us, eu, or aus (defaults to us)

Installation

NPX (Recommended)

npx @vantasdk/vanta-mcp-server

Global Installation

npm install -g @vantasdk/vanta-mcp-server
vanta-mcp-server

From Source

git clone https://github.com/VantaInc/vanta-mcp-server.git
cd vanta-mcp-server
npm install
npm run build
npm start

Build from Source

To build from source:

npm run build

This will:

1. Compile TypeScript to JavaScript
2. Make the output executable
3. Place built files in the build/ directory

Now you can configure Claude Desktop or Cursor to use the built executable:

{
  "mcpServers": {
    "Vanta": {
      "command": "node",
      "args": ["/absolute/path/to/vanta-mcp-server/build/index.js"],
      "env": {
        "VANTA_ENV_FILE": "/absolute/path/to/your/vanta-credentials.env"
      }
    }
  }
}

Development

This server is built with TypeScript and includes the following development tools:

• TypeScript: For type safety and better development experience
• ESLint: For code quality and consistency
• Automated Tool Registry: Zero-maintenance tool registration system
• DRY Utilities: Centralized utilities to reduce code duplication

Project Structure

vanta-mcp-server/
├── src/
│   ├── operations/              # MCP tool implementations
│   │   ├── index.ts            # Barrel export for all operations
│   │   ├── common/             # Shared utilities and infrastructure
│   │   │   ├── descriptions.ts # Centralized parameter descriptions
│   │   │   ├── imports.ts      # Common imports barrel for operations
│   │   │   └── utils.ts        # DRY utilities and request handlers
│   │   ├── controls.ts         # Control-related operations
│   │   ├── vendors.ts          # Vendor-related operations
│   │   ├── people.ts           # People-related operations
│   │   ├── documents.ts        # Document-related operations
│   │   ├── frameworks.ts       # Framework-related operations
│   │   ├── risks.ts            # Risk scenario operations
│   │   ├── tests.ts            # Test-related operations
│   │   ├── integrations.ts     # Integration-related operations (consolidated)
│   │   ├── discovered-vendors.ts # Discovery operations (consolidated)
│   │   ├── trust-centers.ts    # Trust Center operations
│   │   └── ...                 # Other resource operations (18 total)
│   ├── eval/                   # Evaluation and testing framework
│   │   ├── eval.ts            # LLM evaluation test cases
│   │   └── README.md          # Evaluation documentation
│   ├── api.ts                  # Base API configuration
│   ├── auth.ts                 # Authentication handling
│   ├── config.ts               # Control enabled tools
│   ├── index.ts                # Main server entry point
│   ├── registry.ts             # Automated tool registration
│   └── types.ts                # Type definitions
├── build/                      # Compiled JavaScript output
└── README.md                   # This file

Architecture Highlights

• Consolidated Tool Pattern: Single tools intelligently handle both list and get operations with optional ID parameters
• Reduced Complexity: 43 tools (down from 53) through smart consolidation while maintaining full functionality
• Clean Organization: Operations files are cleanly separated from infrastructure code
• Common Subdirectory: All shared utilities, imports, and descriptions are organized in operations/common/
• Automated Registry: New tools are automatically discovered and registered without manual configuration
• DRY Principles: Extensive code reuse through centralized utilities and schema factories
• Type Safety: Full TypeScript coverage with comprehensive type definitions

For detailed architecture documentation, see src/operations/README.md.

Debugging

You can use the MCP Inspector to debug the server:

npx @modelcontextprotocol/inspector npx @vantasdk/vanta-mcp-server

The inspector will open in your browser, allowing you to test tool calls and inspect the server's behavior.

If you want to test a local build you can do so using:

npx @modelcontextprotocol/inspector node path/to/build/index.js

In the browser window you will then need to add the environment variable "VANTA_ENV_FILE": "/absolute/path/to/your/vanta-credentials.env"

Example Usage

Get failing AWS tests for SOC2

{
  "tool": "list_tests",
  "arguments": {
    "statusFilter": "NEEDS_ATTENTION",
    "integrationFilter": "aws",
    "frameworkFilter": "soc2",
    "pageSize": 50
  }
}

License

This project is licensed under the terms of the MIT open source license. Please refer to LICENSE file for details.