conecto. Get started
Vault

Read a secret

vault_get · Reads only · Markdown

A secret's value, for this call only; it is never kept in the call log, and each read is counted.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Log in to the Cascade dealer portal and check when our tire order ships.

Your agent callsvault_getFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "name": "Cascade dealer portal"
}
What comes back
{
  "name": "Cascade dealer portal",
  "value": "birch-anchor-saddle-1871",
  "username": "orders@halversoncycle.example",
  "url": "https://dealers.cascadebikesupply.example"
}

Use it when

Right before the agent signs in somewhere or calls another service with the secret.

What it does

A secret's value, for this call only: it is never stored in the call log. Each read is counted.

What comes back

The name, value, username and url. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
nameRequiredstringe.g. "Shopify admin" or "SUPPLIER_API_KEY". Matches ^[A-Za-z0-9][A-Za-z0-9 ._-]{0,79}$.

The call

Over MCP, call vault_get on https://api.conecto.chat/mcp/vault. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/vault_get \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Cascade dealer portal"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No secret in the vault has that name.Call vault_list for the names.
forbidden403The secret is limited to other bots of the business.Ask the owner, or the bot that saved it, to add this bot.
unavailable503The vault is not available right now.Try again later; nothing was charged.

More Vault tools

All 5 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md