StackQL MCP Server Now Available
StackQL now supports the Model Context Protocol (MCP). This integration enables AI agents and assistants to query and manage cloud infrastructure across multiple providers using natural language.
What is the Model Context Protocol?
The Model Context Protocol is an open standard that enables AI applications to securely connect to external data sources and tools. By running StackQL as an MCP server, AI agents like Claude, ChatGPT, and other LLM-based assistants can interact with your cloud infrastructure using StackQL's powerful SQL-based query capabilities.
Why MCP + StackQL?
Combining MCP with StackQL creates a powerful interface for AI-assisted infrastructure management:
- Natural Language Infrastructure Queries: Ask questions about your cloud resources in plain English and get structured data back
- Multi-Cloud Support: Access resources across AWS, Google Cloud, Azure, and 100+ other providers through a single interface
- Secure and Standardized: MCP provides a secure, standardized way for AI agents to interact with your infrastructure
- SQL-Powered Analytics: Leverage StackQL's full SQL capabilities including joins, aggregations, and complex queries through AI agents
Deployment Options
StackQL's MCP server supports three flexible deployment modes to suit different architectural requirements:
1. Standalone MCP Server
Perfect for development and AI agent integration:
stackql mcp \
--mcp.server.type=http \
--mcp.config '{"server": {"transport": "http", "address": "127.0.0.1:9912"}}'
2. Dual-Protocol Server (In-Memory)
Run both MCP and PostgreSQL wire protocol simultaneously with high-performance in-memory communication:
stackql srv \
--mcp.server.type=http \
--mcp.config '{"server": {"transport": "http", "address": "127.0.0.1:9912"}}' \
--pgsrv.port 5665
This mode is ideal when you need both AI agent access and traditional database client connectivity.
3. Reverse Proxy with TLS
For production environments requiring distributed deployments and encrypted connections:
stackql srv \
--mcp.server.type=reverse_proxy \
--mcp.config '{"server": {"tls_cert_file": "/path/to/cert.pem", "tls_key_file": "/path/to/key.pem", "transport": "http", "address": "127.0.0.1:9004"}, "backend": {"dsn": "postgres://stackql:stackql@127.0.0.1:5446?default_query_exec_mode=simple_protocol"}}' \
--pgsrv.port 5446
Available MCP Tools
When running as an MCP server, StackQL exposes several tools that AI agents can invoke:
| Tool | Description |
|---|---|
greet | Test connectivity with the MCP server |
list_providers | List all available StackQL providers |
list_services | List services for a specific provider |
list_resources | List resources within a provider service |
list_methods | List available methods for a resource |
query_v2 | Execute StackQL queries |
Integration with Claude Desktop
To integrate StackQL with Claude Desktop, add this configuration to your MCP settings file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"stackql": {
"command": "stackql",
"args": [
"mcp",
"--mcp.server.type=http",
"--mcp.config",
"{\"server\": {\"transport\": \"http\", \"address\": \"127.0.0.1:9912\"}}"
]
}
}
}
Example Use Cases
Once configured, you can ask your AI assistant questions like:
- "Show me all my EC2 instances across all AWS regions"
- "List all Google Cloud Storage buckets with public access"
- "Find all Azure virtual machines that haven't been updated in 30 days"
- "Compare compute costs across AWS, Azure, and GCP"
- "Show me IAM policies that grant admin access in my Google Cloud projects"
The AI agent will use StackQL's MCP server to execute the appropriate queries and return structured results.
Example Query Flow
Here's how an AI agent interacts with StackQL via MCP:
# AI agent lists available providers
Tool: list_providers
Response: ["google", "aws", "azure", "github", ...]
# AI agent explores a provider's services
Tool: list_services
Args: {"provider": "google"}
Response: ["compute", "storage", "cloudresourcemanager", ...]
# AI agent executes a query
Tool: query_v2
Args: {"sql": "SELECT name, status FROM google.compute.instances WHERE project = 'my-project' AND zone = 'us-east1-a'"}
Response: [{"name": "instance-1", "status": "RUNNING"}, ...]
Getting Started
-
Download StackQL version 0.9.250 or later from stackql.io/install
-
Set up provider authentication:
export GOOGLE_CREDENTIALS=$(cat /path/to/credentials.json)
export AWS_ACCESS_KEY_ID=your-access-key
export AWS_SECRET_ACCESS_KEY=your-secret-key
- Start the MCP server:
stackql mcp \
--mcp.server.type=http \
--mcp.config '{"server": {"transport": "http", "address": "127.0.0.1:9912"}}'
- Configure your AI assistant to use the StackQL MCP server (see MCP documentation for details)
Documentation
For comprehensive documentation on configuring and using the MCP server, including:
- Detailed configuration options
- TLS/mTLS setup
- Architecture considerations
- Testing and troubleshooting
Visit the MCP command documentation.
What's Next?
We're actively developing additional MCP capabilities and welcome your feedback. Future enhancements may include:
- Enhanced resource provisioning and lifecycle management through MCP
- Built-in prompt templates for common infrastructure queries
- Extended tool catalog for specialized operations
- Support for additional MCP transport protocols
Try It Out!
The MCP server feature is available now in StackQL 0.9.250. We'd love to hear about your experiences integrating StackQL with AI agents. Share your use cases, provide feedback, or contribute to the project on GitHub.
⭐ Star us on GitHub and join our community!