Encrypted store for API keys and database URLs your code needs. Use them without reading them.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. Leave unset to connect anonymously — the tool list and instructions are public, and the `signup` tool mints your own credential. Once you have one: HTTP Basic, base64(clientId:clientSecret).
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Read the organization's append-only audit trail, most recent first — every mutation across apps, environments, secrets, members, and tokens. Use it to answer "what changed and who did it"; for one secret's history specifically, list_secret_versions is narrower and cheaper. Returns [{ id, action, actorType, actorId, resourceType, resourceId, metadata, ipAddress, createdAt }].
Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs.
How many entries to return, newest first. 1–200, default 50.
Exact action name to filter by, e.g. "secret.updated" or "app.deleted". Omit for every action. Read the values off an unfiltered call rather than guessing.
Read the organization's append-only audit trail, most recent first — every mutation across apps, environments, secrets, members, and tokens. Use it to answer "what changed and who did it"; for one secret's history specifically, list_secret_versions is narrower and cheaper. Returns [{ id, action, actorType, actorId, resourceType, resourceId, metadata, ipAddress, createdAt }].
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| limit | integer | How many entries to return, newest first. 1–200, default 50. |
| action | string | Exact action name to filter by, e.g. "secret.updated" or "app.deleted". Omit for every action. Read the values off an unfiltered call rather than guessing. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "How many entries to return, newest first. 1–200, default 50."
},
"action": {
"type": "string",
"description": "Exact action name to filter by, e.g. \"secret.updated\" or \"app.deleted\". Omit for every action. Read the values off an unfiltered call rather than guessing."
}
}
}Show the org's plan, effective entitlements, current usage, and which upgrade actions are available. Read this if a create action was refused with a plan limit — it names the limit you hit and how to lift it. Returns { plan, subscription, promo, entitlements, usage, overrides, enforced, manage } — `enforced: false` means plan limits are not currently applied, and `manage` carries the upgrade paths.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}Compose a shared group into an application environment, so that environment resolves the group's secrets as well as its own. Safe to repeat — composing an already-composed group just updates its position. Use uncompose_group to undo, and list_env_groups to see the current order. No key material involved, so it runs here. Returns the composed { groupId, slug, name, position }.
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| env* | string | Environment slug or id within that application, as returned by list_envs (e.g. "production"). |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| group* | string | Shared-group slug or id, as returned by list_groups (e.g. "shared-datastores"). |
| position | integer | Precedence among the environment's composed groups: on a name clash the HIGHER position wins, and the environment's own secrets beat every group. Omit to append at the end. Read the current order from list_env_groups first. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app",
"env",
"group"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"env": {
"type": "string",
"description": "Environment slug or id within that application, as returned by list_envs (e.g. \"production\")."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"group": {
"type": "string",
"description": "Shared-group slug or id, as returned by list_groups (e.g. \"shared-datastores\")."
},
"position": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Precedence among the environment's composed groups: on a name clash the HIGHER position wins, and the environment's own secrets beat every group. Omit to append at the end. Read the current order from list_env_groups first."
}
}
}Create an application — the container that will own environments and secrets. This step needs no key material, so it runs here. Creating its environments does NOT: create_env mints a data key and lives on the local crypto plane (call setup_local_crypto). Returns the new { id, orgId, name, slug, createdAt }.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| name* | string | Human-readable display name, e.g. "Acme Storefront". Can be renamed later. |
| slug* | string | URL-safe identifier used by every other tool to refer to this app: lowercase letters, numbers, hyphens (e.g. "acme-storefront"). Immutable once created — choose it carefully. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"slug"
],
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"name": {
"type": "string",
"description": "Human-readable display name, e.g. \"Acme Storefront\". Can be renamed later."
},
"slug": {
"type": "string",
"description": "URL-safe identifier used by every other tool to refer to this app: lowercase letters, numbers, hyphens (e.g. \"acme-storefront\"). Immutable once created — choose it carefully."
}
}
}Create a shared group — a reusable bag of secrets (a shared datastore, a vendor account) that many application environments compose in rather than each keeping a copy. Use create_app instead for a deployable service. No key material involved, so it runs here; the group's environments are minted locally by create_group_env. Returns the new { id, orgId, name, slug, createdAt }.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| name* | string | Human-readable display name, e.g. "Shared Datastores". Can be renamed later. |
| slug* | string | URL-safe identifier the other tools refer to this group by: lowercase letters, numbers, hyphens (e.g. "shared-datastores"). Immutable once created. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"slug"
],
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"name": {
"type": "string",
"description": "Human-readable display name, e.g. \"Shared Datastores\". Can be renamed later."
},
"slug": {
"type": "string",
"description": "URL-safe identifier the other tools refer to this group by: lowercase letters, numbers, hyphens (e.g. \"shared-datastores\"). Immutable once created."
}
}
}Delete an application together with all of its environments and their secrets, discarding the ciphertext. Irreversible — there is no undo and no export. This is the widest-blast-radius tool here; prefer delete_env for a single environment, or rename_app if the name is the only problem. Confirm intent with a human before calling. Returns { ok, app }.
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}Tear down an ephemeral branch config and every value it overrode. The parent environment is untouched — only the branch's own overrides go — which makes this the routine cleanup when a PR merges. Irreversible; creating a branch mints a data key, so create_branch stays on the local crypto plane. Find the slug with list_branches. Returns { ok, branch }.
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| branch* | string | Branch slug or id within the application, as returned by list_branches. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app",
"branch"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"branch": {
"type": "string",
"description": "Branch slug or id within the application, as returned by list_branches."
}
}
}Delete one application environment and the secrets it owns, discarding the ciphertext. Irreversible, and the environment's data key goes with it — recreating the environment means setting every value again on the local crypto plane. Sibling environments and the application itself are untouched; use delete_app to remove all of them. Confirm intent before calling. Returns { ok, env }.
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| env* | string | Environment slug or id within that application, as returned by list_envs (e.g. "production"). |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app",
"env"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"env": {
"type": "string",
"description": "Environment slug or id within that application, as returned by list_envs (e.g. \"production\")."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}Delete a shared group together with its environments and their secrets, discarding the ciphertext. Irreversible. Every application environment that composed this group loses those names — check list_env_groups (or use uncompose_group) before deciding the group is unused. Confirm intent before calling. Returns { ok, group }.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| group* | string | Shared-group slug or id, as returned by list_groups (e.g. "shared-datastores"). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"group"
],
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"group": {
"type": "string",
"description": "Shared-group slug or id, as returned by list_groups (e.g. \"shared-datastores\")."
}
}
}Delete a secret from an environment, discarding its ciphertext and every version. Irreversible — restore_secret CANNOT bring it back (that only rolls back within a surviving secret's history), and re-creating it means setting the value again on the local crypto plane. Prefer restore_secret to undo a bad write. Confirm intent before calling. Returns { ok, name } — or { ok, queued: true, changeRequestId } if the environment requires approval, in which case NOTHING was deleted until a human approves.
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| env* | string | Environment slug or id within that application, as returned by list_envs (e.g. "production"). |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| name* | string | The secret's name — the variable name it is injected as, e.g. "DATABASE_URL". Names come from list_secrets; this is never a value. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app",
"env",
"name"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"env": {
"type": "string",
"description": "Environment slug or id within that application, as returned by list_envs (e.g. \"production\")."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"name": {
"type": "string",
"description": "The secret's name — the variable name it is injected as, e.g. \"DATABASE_URL\". Names come from list_secrets; this is never a value."
}
}
}Read the recommended first-project recipe end to end: which steps run here and which need the local crypto plane. Takes no arguments and returns a prose walkthrough. Call this before provisioning anything — it is cheaper than discovering the plane boundary one failed tool at a time.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Invite a human to the organization by email (admin only). They join at the given role once they sign in. Use this to hand a project off to a person — then grant them decryption with `grant_env` on the LOCAL crypto plane, since an invite alone conveys no ability to read values. Returns the pending { id, orgId, email, role, invitedById, createdAt }; revoke_invite cancels it.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| role | string | Role granted on join. "member" (the default) can use the org; "admin" can also invite others and delete resources. |
| email* | string | Email address to invite. They receive an invitation and become a member on first sign-in; until then they appear in list_invites, not list_members. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"email"
],
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"role": {
"enum": [
"member",
"admin"
],
"type": "string",
"description": "Role granted on join. \"member\" (the default) can use the org; \"admin\" can also invite others and delete resources."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Email address to invite. They receive an invitation and become a member on first sign-in; until then they appear in list_invites, not list_members."
}
}
}Disable a managed KMS key: new encrypt/sign operations are blocked, while data already encrypted under it stays decryptable locally by existing grantees. Reversible only by an operator re-enabling the key — there is no enable tool here. Use kms_revoke_grant instead to cut off ONE principal while the key stays in service. Find the id with kms_list_keys. Returns the updated key, with `disabledAt` now set.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| keyId* | string | The managed key's id, from kms_list_keys (the `id` field — `name` is a display label and is not accepted here). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"keyId"
],
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"keyId": {
"type": "string",
"description": "The managed key's id, from kms_list_keys (the `id` field — `name` is a display label and is not accepted here)."
}
}
}List the managed KMS keys the caller can see — symmetric and signing keys seekrit stores wrapped, for encrypting data outside the secret store. Metadata only: key material is fetched and used on the local crypto plane (kms_encrypt / kms_decrypt / kms_sign live there, not here). Use it to find a `keyId` for kms_disable_key or kms_revoke_grant. Returns [{ id, name, purpose, spec, currentVersion, applicationId, groupId, disabledAt, createdAt }] — a non-null `disabledAt` means the key is already disabled.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}Revoke one principal's grant on a managed KMS key, across all its versions — that user or service token can no longer use the key, while everyone else keeps working. Use kms_disable_key instead to stop the key entirely. Removing a grant needs no key material, which is why it runs here. Returns { ok, keyId, principalId }.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| keyId* | string | The managed key's id, from kms_list_keys (the `id` field — `name` is a display label and is not accepted here). |
| principalId* | string | The principal's id — a `userId` from list_members, or a token `id` from list_tokens, matching principalType. |
| principalType* | string | What kind of principal to revoke: "user" for a human member (list_members) or "service_token" for a machine credential (list_tokens). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"keyId",
"principalType",
"principalId"
],
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"keyId": {
"type": "string",
"description": "The managed key's id, from kms_list_keys (the `id` field — `name` is a display label and is not accepted here)."
},
"principalId": {
"type": "string",
"description": "The principal's id — a `userId` from list_members, or a token `id` from list_tokens, matching principalType."
},
"principalType": {
"enum": [
"user",
"service_token"
],
"type": "string",
"description": "What kind of principal to revoke: \"user\" for a human member (list_members) or \"service_token\" for a machine credential (list_tokens)."
}
}
}List the applications in an organization — an application is the top-level container that owns environments, which in turn own secrets. Start here when you know the org but not the app slug the other tools need. Returns [{ id, orgId, name, slug, createdAt }]; use list_envs next to descend into one.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}List ephemeral branch configs (per-PR / preview environments) across an application, or just those forked from one environment. Names, parents, and expiry only — never values. Use it before delete_branch to find a branch slug, or to spot branches that have already expired. Returns Environment rows with `parentEnvironmentId` set: [{ id, name, slug, parentEnvironmentId, expiresAt, createdAt }] — `expiresAt` is null for a branch with no TTL.
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| env | string | Optional environment slug or id to narrow to branches forked from that one environment. Omit to list every branch in the application. |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"env": {
"type": "string",
"description": "Optional environment slug or id to narrow to branches forked from that one environment. Omit to list every branch in the application."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}List the shared groups composed INTO one application environment, in precedence order (higher position wins a name clash). Read this to explain where a secret name actually comes from, or to pick the next `position` for compose_group. The inverse direction of list_group_envs. Returns [{ groupId, slug, name, position }], highest position last.
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| env* | string | Environment slug or id within that application, as returned by list_envs (e.g. "production"). |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app",
"env"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"env": {
"type": "string",
"description": "Environment slug or id within that application, as returned by list_envs (e.g. \"production\")."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}List the environments an application owns (production, staging, …). Names and slugs only — never values. Use this to find the `env` slug that list_secrets and the delete/restore tools take. Returns [{ id, name, slug, applicationId, groupId, parentEnvironmentId, expiresAt, createdAt }]. Not to be confused with list_env_groups (which groups feed INTO an app environment) or list_group_envs (the environments of a shared GROUP).
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}List the environments belonging to one shared GROUP — a group holds a separate value set per slug, so its `production` differs from its `staging`. Use this when you already have a group and want its own environments; use list_envs for an application's, and list_env_groups to see which groups an application environment pulls from. Returns Environment rows with `groupId` set: [{ id, name, slug, groupId, createdAt }].
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| group* | string | Shared-group slug or id, as returned by list_groups (e.g. "shared-datastores"). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"group"
],
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"group": {
"type": "string",
"description": "Shared-group slug or id, as returned by list_groups (e.g. \"shared-datastores\")."
}
}
}List the shared groups in an organization — a group is a reusable bag of secrets (a shared datastore, a vendor account) that many application environments can compose in rather than duplicating. Use it to find the `group` slug compose_group and list_group_envs take. Returns [{ id, orgId, name, slug, createdAt }]; not paginated.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}List invitations to the organization that have been sent but not yet accepted. Use it to confirm an invite_member call landed, or to find an `inviteId` for revoke_invite. Accepted invitations become members — see list_members. Returns [{ id, orgId, email, role, invitedById, createdAt }].
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}List the registered temporary-access targets — the databases (Postgres, MySQL, …) against which short-lived credentials can be minted on demand instead of storing a standing password. Use it to see what can be leased before minting one (create_pg_lease / create_mysql_lease run on the LOCAL crypto plane), and see list_leases for what has actually been issued. Returns [{ id, orgId, provider, name, config, createdAt }], where `provider` names the kind of target (postgres, mysql, …) and `config` is non-secret connection settings.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}List temporary-access leases that have been issued — the ledger of who got a short-lived credential against which target and until when. Never includes the credential itself. Use it to find a `leaseId` for revoke_lease, or to check whether a lease has already expired before revoking it; list_lease_targets shows what CAN be leased. Returns [{ id, targetId, provider, status, principalType, principalId, expiresAt, endedAt, endedReason, createdAt }] — only `status: "active"` leases are worth revoking.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}List organization members with their public keys. The public keys are what you pass to `grant_env` on the LOCAL crypto plane to give a human the ability to decrypt — so call this when handing a project off to a person. Returns [{ userId, email, name, role, publicKeyJwk }]; `publicKeyJwk` is null for a member who has not finished key setup, and such a member cannot be granted decryption yet.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}List the organizations this credential can access. Use it to find the `org` slug every other tool takes; prefer whoami if you also want to confirm which client you are. Returns [{ id, name, slug, role, createdAt }].
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}List one secret's version history: who wrote each version, when, and which ones were restores. Metadata only — never values. Pair with restore_secret to undo a bad write: read the history here, then pass the version number you want back. Returns { currentVersion, versions: [{ version, createdAt, createdBy, restoredFromVersion }] }, newest first.
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| env* | string | Environment slug or id within that application, as returned by list_envs (e.g. "production"). |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| name* | string | The secret's name — the variable name it is injected as, e.g. "DATABASE_URL". Names come from list_secrets; this is never a value. |
| limit | integer | How many versions to return, newest first. 1–200, default 20. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app",
"env",
"name"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"env": {
"type": "string",
"description": "Environment slug or id within that application, as returned by list_envs (e.g. \"production\")."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"name": {
"type": "string",
"description": "The secret's name — the variable name it is injected as, e.g. \"DATABASE_URL\". Names come from list_secrets; this is never a value."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "How many versions to return, newest first. 1–200, default 20."
}
}
}List the secret NAMES and versions in an environment. NEVER returns values: this server cannot decrypt. Use it to discover which names exist before referencing them; to read a value, run the local crypto plane (see setup_local_crypto) — no tool here will ever return one. Returns [{ name, version, updatedAt }].
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| env* | string | Environment slug or id within that application, as returned by list_envs (e.g. "production"). |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app",
"env"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"env": {
"type": "string",
"description": "Environment slug or id within that application, as returned by list_envs (e.g. \"production\")."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}List an organization's service tokens — the long-lived credentials that let a deployed workload fetch secrets. Metadata only: the token strings are shown once at creation (on the local crypto plane) and are never retrievable here. Use it to find a `tokenId` for revoke_token, or to audit what still has access. Returns [{ id, name, role, environmentId, expiresAt, lastUsedAt, revokedAt, createdAt }] — `environmentId` is null for an org-admin token, and a non-null `revokedAt` means it is already revoked.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
}
}
}Look up how to perform one crypto-plane operation locally — the targeted answer for "the tool I expected is not on this server". Returns { operation, where, how } for a known operation, or a note explaining the plane boundary for an unrecognised one. Use setup_local_crypto instead when you need the whole local setup rather than one command.
| Argument | Type | Description |
|---|---|---|
| operation* | string | The tool name you were looking for, in snake_case as it appears on the local plane — e.g. "set_secret", "get_secret", "create_env", "create_token", "grant_env", "run_command". Unknown names return the general boundary rule rather than an error. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"operation"
],
"properties": {
"operation": {
"type": "string",
"description": "The tool name you were looking for, in snake_case as it appears on the local plane — e.g. \"set_secret\", \"get_secret\", \"create_env\", \"create_token\", \"grant_env\", \"run_command\". Unknown names return the general boundary rule rather than an error."
}
}
}Change an application's display name. The slug is immutable — every other tool refers to the app by slug, so a rename breaks nothing. Use delete_app + create_app only if the slug itself must change. Returns the updated { id, orgId, name, slug, createdAt }.
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| name* | string | The new display name, e.g. "Acme Storefront (EU)". |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app",
"name"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"name": {
"type": "string",
"description": "The new display name, e.g. \"Acme Storefront (EU)\"."
}
}
}Change a shared group's display name. The slug is immutable — references from composed environments are by slug, so a rename breaks nothing. Returns the updated { id, orgId, name, slug, createdAt }.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| name* | string | The new display name, e.g. "Shared Datastores (EU)". |
| group* | string | Shared-group slug or id, as returned by list_groups (e.g. "shared-datastores"). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"group",
"name"
],
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"name": {
"type": "string",
"description": "The new display name, e.g. \"Shared Datastores (EU)\"."
},
"group": {
"type": "string",
"description": "Shared-group slug or id, as returned by list_groups (e.g. \"shared-datastores\")."
}
}
}Roll a secret back to an earlier version — the undo for a bad write. The stored ciphertext is replayed as a NEW version, so history is append-only and nothing is overwritten. Read list_secret_versions first to choose the version. No decryption happens, which is why this works here and not only on the local crypto plane. Returns { ok, name, restoredFrom, version } where `version` is the new head.
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| env* | string | Environment slug or id within that application, as returned by list_envs (e.g. "production"). |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| name* | string | The secret's name — the variable name it is injected as, e.g. "DATABASE_URL". Names come from list_secrets; this is never a value. |
| version* | integer | The version number to restore, taken from list_secret_versions. Its ciphertext becomes a new version on top of history — the old version is not removed. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app",
"env",
"name",
"version"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"env": {
"type": "string",
"description": "Environment slug or id within that application, as returned by list_envs (e.g. \"production\")."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"name": {
"type": "string",
"description": "The secret's name — the variable name it is injected as, e.g. \"DATABASE_URL\". Names come from list_secrets; this is never a value."
},
"version": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The version number to restore, taken from list_secret_versions. Its ciphertext becomes a new version on top of history — the old version is not removed.",
"exclusiveMinimum": 0
}
}
}Cancel a pending organization invitation before it is accepted. Use this for an invite sent in error; once someone has accepted, they are a member and this no longer applies. Find the id with list_invites. Returns { ok, inviteId }.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| inviteId* | string | The pending invitation's id, from list_invites. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"inviteId"
],
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"inviteId": {
"type": "string",
"description": "The pending invitation's id, from list_invites."
}
}
}Revoke a temporary-access lease now instead of waiting for it to expire — the leased database credential is dropped at the target immediately, so anything still holding it fails on its next connection. Irreversible: a new lease must be minted on the local crypto plane. Check list_leases first, since an already-expired lease needs no revoking. Returns { ok, leaseId }.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| leaseId* | string | The lease's id from list_leases (not the target's id — see list_lease_targets). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"leaseId"
],
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"leaseId": {
"type": "string",
"description": "The lease's id from list_leases (not the target's id — see list_lease_targets)."
}
}
}Revoke a service token by id. Future key fetches by that token stop immediately, so any workload still using it loses access on its next read. If the holder may have cached the key already, also rotate the environment on the local crypto plane — revocation alone does not re-encrypt anything. Find the id with list_tokens. Returns { ok, tokenId }.
| Argument | Type | Description |
|---|---|---|
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| tokenId* | string | The token's id from list_tokens — not the token string, which is never stored. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tokenId"
],
"properties": {
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"tokenId": {
"type": "string",
"description": "The token's id from list_tokens — not the token string, which is never stored."
}
}
}Get the exact commands for running the local crypto plane (the `@seekrit/mcp` npm server, the `@seekrit/cli` CLI, seekrit-run, seekrit-proxy), including a copy-paste .mcp.json that reuses this session's credential. Takes no arguments and returns prose plus config. Call this the moment you need to SET or READ a secret value — no tool on this server will ever return one. Use local_tool_for instead when you want the single command for one named operation.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Create a seekrit workspace and your own machine credential — one call, no human, no browser. Binds the credential to this session, so every other tool works on your next call with no config change and no reconnect. Returns { org, credential: { clientId, clientSecret }, sessionBound, next }. Save the clientId + clientSecret: the secret is shown once, is not retrievable, and is how you reconnect later. Call this if a tool says you have no credential.
| Argument | Type | Description |
|---|---|---|
| orgName* | string | The real project, product, or company this workspace is for (e.g. "Acme Storefront") — NOT a placeholder like "test" or "agent". A human will later claim the org by this name. |
| orgSlug* | string | URL-safe identifier derived from the project, lowercase letters/numbers/hyphens (e.g. "acme-storefront"). Throwaway slugs make the org unmanageable. |
| clientName | string | Optional label for this machine credential (defaults to <slug>-agent). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orgName",
"orgSlug"
],
"properties": {
"orgName": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "The real project, product, or company this workspace is for (e.g. \"Acme Storefront\") — NOT a placeholder like \"test\" or \"agent\". A human will later claim the org by this name."
},
"orgSlug": {
"type": "string",
"minLength": 1,
"description": "URL-safe identifier derived from the project, lowercase letters/numbers/hyphens (e.g. \"acme-storefront\"). Throwaway slugs make the org unmanageable."
},
"clientName": {
"type": "string",
"description": "Optional label for this machine credential (defaults to <slug>-agent)."
}
}
}Remove a composed group from an application environment. The group and its secrets are untouched — only the link is dropped — but the environment stops resolving every name it inherited from that group, which will break a workload still reading one. Check list_env_groups first, and use delete_group to destroy the group itself. Safe to repeat. Returns { ok: true }.
| Argument | Type | Description |
|---|---|---|
| app* | string | Application slug or id, as returned by list_apps (e.g. "storefront"). |
| env* | string | Environment slug or id within that application, as returned by list_envs (e.g. "production"). |
| org | string | Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs. |
| group* | string | Shared-group slug or id, as returned by list_groups (e.g. "shared-datastores"). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"app",
"env",
"group"
],
"properties": {
"app": {
"type": "string",
"description": "Application slug or id, as returned by list_apps (e.g. \"storefront\")."
},
"env": {
"type": "string",
"description": "Environment slug or id within that application, as returned by list_envs (e.g. \"production\")."
},
"org": {
"type": "string",
"description": "Organization slug or id. Omit it when the credential can reach exactly one org — that org is used automatically. With several, the error names every slug you may pass; list them yourself with list_orgs."
},
"group": {
"type": "string",
"description": "Shared-group slug or id, as returned by list_groups (e.g. \"shared-datastores\")."
}
}
}Show the authenticated machine client and the org it can access. Call this first: it confirms the credential works and tells you which org slug to pass (or that you can omit `org` entirely). Returns { kind, clientId, orgs: [{ id, name, slug, role, createdAt }] }.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}