MCP Tools Reference

All tools accept optional org, project, and env parameters. When omitted, defaults from coldrune.yml or environment variables are used.

Secret tools

secret_set

Set (create or update) a secret value in a Coldrune environment.

Parameter	Type	Required	Description
key	string	yes	Secret key name (e.g. DATABASE_URL, API_KEY)
value	string	yes	Secret value
org	string	no	Organization name
project	string	no	Project name
env	string	no	Environment name

secret_get

Get a secret’s decrypted value from a Coldrune environment.

Parameter	Type	Required	Description
key	string	yes	Secret key name
org	string	no	Organization name
project	string	no	Project name
env	string	no	Environment name

secret_list

List all secret keys in a Coldrune environment. Values are not returned.

Parameter	Type	Required	Description
org	string	no	Organization name
project	string	no	Project name
env	string	no	Environment name

secret_delete

Delete a secret from a Coldrune environment (soft delete).

Parameter	Type	Required	Description
key	string	yes	Secret key name to delete
org	string	no	Organization name
project	string	no	Project name
env	string	no	Environment name

Project tools

project_create

Create a new project in a Coldrune organization. Automatically creates dev, staging, and prod environments.

Parameter	Type	Required	Description
name	string	yes	Project name (lowercase alphanumeric + hyphens, 2-50 chars)
org	string	no	Organization name

project_list

List all projects in a Coldrune organization.

Parameter	Type	Required	Description
org	string	no	Organization name

project_delete

Delete a project from a Coldrune organization (soft delete).

Parameter	Type	Required	Description
name	string	yes	Project name to delete
org	string	no	Organization name

Environment tools

env_create

Create a new environment in a Coldrune project.

Parameter	Type	Required	Description
name	string	yes	Environment name (lowercase alphanumeric + hyphens, 2-50 chars)
org	string	no	Organization name
project	string	no	Project name

env_list

List all environments in a Coldrune project.

Parameter	Type	Required	Description
org	string	no	Organization name
project	string	no	Project name

env_delete

Delete an environment from a Coldrune project (soft delete).

Parameter	Type	Required	Description
name	string	yes	Environment name to delete
org	string	no	Organization name
project	string	no	Project name

Organization tools

org_list

List all organizations the authenticated user belongs to. No parameters required.

org_members_list

List all members of a Coldrune organization with their roles.

Parameter	Type	Required	Description
org	string	no	Organization name

Access control & audit tools

acl_list

List access control rules for a Coldrune organization.

Parameter	Type	Required	Description
org	string	no	Organization name

audit_list

List audit log entries for a Coldrune organization with optional filters.

Parameter	Type	Required	Description
org	string	no	Organization name
action	string	no	Filter by action (e.g. secret.set, org.create)
actor	string	no	Filter by actor ID
resource_type	string	no	Filter by resource type
limit	integer	no	Maximum results to return
after	string	no	Pagination cursor

Health tool

health_check

Check if the Coldrune server is reachable and healthy. No parameters required.