Turbot Guardrails Model Context Protocol (MCP) Server

Name: Turbot Guardrails Model Context Protocol (MCP) Server
Author: turbot

@turbot

Repository Homepage

About Turbot Guardrails Model Context Protocol (MCP) Server

Enable AI assistants to explore and query your Turbot Guardrails data!

#mcp #turbot-guardrails #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "guardrails-mcp": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "node",
        "dist/index.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Turbot Guardrails Model Context Protocol (MCP) Server?

This MCP server connects AI assistants such as Claude to a Turbot Guardrails environment, enabling natural language exploration, analysis, and automation across cloud resources. It is designed for cloud engineers and governance teams who want to query, control, and monitor their cloud estate through conversational interfaces.

How to use Turbot Guardrails Model Context Protocol (MCP) Server?

Install via npm (npx -y @turbot/guardrails-mcp) and configure using either a Turbot CLI profile (set TURBOT_PROFILE) or direct environment variables (TURBOT_WORKSPACE, TURBOT_ACCESS_KEY, TURBOT_SECRET_KEY). Legacy v0.1.x variable names are also accepted. Add the configuration to your AI assistant's MCP settings file (e.g., claude_desktop_config.json for Claude Desktop) and restart the assistant.

Key features of Turbot Guardrails Model Context Protocol (MCP) Server

Run read-only GraphQL queries against Guardrails data.
List and filter resources, controls, and policy types.
Execute controls by ID for compliance remediation.
Introspect GraphQL schemas of runnable types.
Render Nunjucks templates for dynamic configurations.

Use cases of Turbot Guardrails Model Context Protocol (MCP) Server

Query cloud resources (e.g., S3 buckets, EC2 instances) using natural language.
Generate compliance and security reports on non-compliant resources.
Explore available policy and control types by category or title.
Run controls on specific resources directly from the AI assistant.
Process and apply Nunjucks templates for dynamic policy or configuration generation.

FAQ from Turbot Guardrails Model Context Protocol (MCP) Server

How do I authenticate to Guardrails?

You can authenticate either by referencing a Turbot CLI profile with TURBOT_PROFILE or by setting the three direct credential variables: TURBOT_WORKSPACE, TURBOT_ACCESS_KEY, and TURBOT_SECRET_KEY. Legacy v0.1.x names (e.g., TURBOT_GRAPHQL_ENDPOINT) are still accepted.

What are the prerequisites?

Node.js version 20 or higher, a valid Guardrails API access key with appropriate permissions, and the endpoint URL for your Guardrails workspace.

Where does the server look for credentials by default?

If using a CLI profile, the server reads ~/.config/turbot/credentials.yml by default. This path can be overridden with the TURBOT_CLI_CREDENTIALS_PATH environment variable.

What should I do if I see authentication errors?

Verify that your API key is correct and has the necessary permissions. Ensure the profile name matches an entry in your credentials file and that the file includes workspace, accessKey, and secretKey. Credential values are redacted from error messages returned to your AI assistant.

How can I test the server locally?

Use the MCP Inspector by running npm run build then npx @modelcontextprotocol/inspector node dist/index.js. This launches an interactive test interface for the server.

Comments

More Other MCP servers

Website

FunnyWolf

Adversary simulation and Red teaming platform with AI

5.1K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K