MCP servers and secrets
Your MCP servers and the tools they offer, and the secrets Bash uses but never shows.
GET/v1/mcp-servers/{server_id}/toolsThe tools we found, each with its setting in the server's tool policy floor.
A deployment version's own policy can add to it.
Request2 fields
Path
server_idstringrequiredThe MCP server's id (mcp_...).
- Type
string
Query
user_idstringYour id for a user, to fill in their ${user_secret:NAME} headers. Absent: the company's own secrets only.
- Type
string
Answers 2002 fields
dataobject[]The items on this page.
object"mcp_tool"Always mcp_tool.
- Type
"mcp_tool"
namestringThe tool's name, as the server gives it.
- Type
string
deniedbooleantrue when the floor says Bash never calls it.
- Type
boolean
requires_approvalbooleantrue when the floor says it waits for the person's yes.
- Type
boolean
next_cursorstring | nullSend it as cursor for the next page; null on the last page.
- Type
string | null
No sample in your language for this route, so here it is over HTTP.
curl "$VESTRA_BASE_URL/v1/mcp-servers/{server_id}/tools" \ -H "Authorization: Bearer $VESTRA_API_KEY"