Find secret keys
find_secret_keysSearch and compare secret key names, never values: across every project, against names you already have, through one key's history, or between two environments. To list all keys of one environment use list_project_items item secrets; to read a value use reveal_values. Actions (arguments besides action):
search (query; optional project): where keys matching query live, in every project this token reaches or only project. query is a case-insensitive substring or a * pattern (NEXT_PUBLIC_*, *_URL). At most 200 matches, not paged.
check (project, keys; optional environment): for exact names you already have (from .env.example, say), the environments each exists in.
history (project, environment, key): the key's versions, newest first, with who changed it and when. Paged: call again with nextCursor until it is null. Pass a version to manage_secrets action restore.
diff (project, from, to): keys only in from, only in to, and in both with different values, compared on the server. Protected, sealed and restricted keys are only counted, in hidden. Run it before manage_secrets action copy. An unknown or unreachable project or environment fails with a message. search, check and history need projects:read; diff needs secrets:read on both environments and is audited.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "find_secret_keys"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | diff only: the second environment | |
| key | No | history only: the key whose versions to list | |
| from | No | diff only: the first environment | |
| keys | No | check only: exact key names to look for, 1 to 500 | |
| limit | No | history only: versions per page, 1 to 200. Default 100. | |
| query | No | search only: a key substring matched case-insensitively (database), or a pattern where * matches anything (NEXT_PUBLIC_*, *_URL) | |
| action | Yes | What to ask | |
| cursor | No | history only: the nextCursor of the previous page | |
| search | No | history only: filters the versions by their number (not the key; use query for action search) | |
| project | No | check, history and diff: required. search: optional, limits the search to one project | |
| environment | No | history: required, the key's environment. check: optional, only this environment |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| key | No | ||
| from | No | ||
| keys | No | ||
| query | No | ||
| hidden | No | Sealed, protected or restricted keys, counted and never named | |
| current | No | The current version number | |
| matches | No | ||
| project | No | ||
| onlyInTo | No | ||
| versions | No | ||
| different | No | Keys present in both with a different value; names only | |
| truncated | No | More matches exist than are listed | |
| nextCursor | No | Pass as cursor to read the next page; null at the end | |
| onlyInFrom | No | ||
| environment | No | ||
| environments | No | ||
| projectsSearched | No |