Skip to main content

Secrets

MCP tools for the Secrets module. See the Secrets module docs for permissions and data model.

list-secrets​

List secrets

Arguments​

ArgumentTypeRequiredDescription
project_idstringnoProject ID (required if not using project key auth)
limitnumbernoResults per page. Above the maximum it is clamped; below 1 or not an integer it is 400 VALIDATION_FAILED.
cursorstringnoThe previous page's next_cursor; omit it for the first page. Send it with the same filters as the request that returned it: a malformed cursor, or one sent with other filters, is 400 INVALID_CURSOR.

create-secret​

Create a secret

Arguments​

ArgumentTypeRequiredDescription
project_idstringnoProject ID (required if not using project key auth)
namestringyesSecret name
valuestringyesSecret value (will be encrypted)

get-secret​

Get a secret

Arguments​

ArgumentTypeRequiredDescription
secret_idstringyesSecret ID

update-secret​

Update a secret

Arguments​

ArgumentTypeRequiredDescription
secret_idstringyesSecret ID
namestringnoNew secret name
valuestringnoNew secret value

delete-secret​

Delete a secret

Arguments​

ArgumentTypeRequiredDescription
secret_idstringyesSecret ID
forcebooleannoDelete the secret even when AI providers reference it, destroying those providers too. Without it a referenced secret answers SECRET_HAS_DEPENDENTS.