StackQL MCP Server
officialExposes cloud provider control and data planes to agents as self-describing, queryable and mutable data sources using SQL, minimising tool surface and token usage.
What can you do with StackQL MCP?
- Discover cloud resources — Ask which providers, services, and resources are available in the local StackQL cache via
list_providers,list_services, andlist_resources. - Inspect API contracts — Get the full input/output schema for any resource method using
describe_methodbefore writing queries. - Validate and run queries — Check a SELECT statement without executing it via
validate_select_query, then run it withrun_select_query. - Manage providers — See available registry versions and install a provider into the local cache using
list_registryandpull_provider. - Execute mutations — Run INSERT, UPDATE, REPLACE, or DELETE operations against a provider with
run_mutation_query. - Trigger lifecycle ops — Execute StackQL EXEC lifecycle operations (e.g., start/stop instances) via
run_lifecycle_operation.
Documentation
These are the tools exposed by the StackQL MCP server. Availability of mutation and lifecycle tools depends on the server mode (
read_only,safe,delete_safe,full_access). For information on installing the MCP server locally see here.
Server
server_info
Identity and runtime of the connected MCP server
reload_credentials
Re-source credentials from the --env.file dotenv file and report per-provider status
Discovery
list_providers
Providers pulled into the local StackQL cache
list_services
Services available under a provider
list_resources
Resources available under a provider.service
list_methods
Access methods available for a resource
describe_method
Full I/O contract of one access method: inputs and output fields
Registry
list_registry
Providers and versions available in the registry
pull_provider
Install a provider from the registry into the local cache
Query
validate_select_query
Parse and plan a SELECT without executing it
run_select_query
Execute a SELECT against a provider
Mutation & Lifecycle
run_mutation_query
Run INSERT, UPDATE, REPLACE, or DELETE against a provider
run_lifecycle_operation
Execute a StackQL EXEC lifecycle operation