list_credentials

GET

/v1/agents/{agent_id}/credentials

const url = 'https://app.everruns.com/api/v1/agents/example/credentials';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.everruns.com/api/v1/agents/example/credentials

List write-only MCP credential bindings for an agent. Responses contain metadata and configuration status, never credential values.

Parameters

Path Parameters

agent_id

required

string

Agent ID

Responses

200

Credential binding metadata

application/json

Response wrapper for list endpoints. All list endpoints return responses wrapped in a data field.

object

data

required

Array of items returned by the list operation.

Array<object>

Metadata for a write-only credential bound to one agent and MCP tool parameter.

object

agent_id

required

Agent that exclusively owns and may use this credential.

string

configured

required

Whether an encrypted value has been provisioned.

boolean

created_at

required

RFC 3339 creation time.

string

description

Optional explanation of why the credential is needed.

string | null

required

Stable credential binding identifier.

string format: uuid

label

required

Human-readable credential label.

string

mcp_server_name

required

Name of the attached MCP server.

string

mcp_server_url

required

Exact MCP endpoint authorized to receive the credential.

string

parameter_name

required

Top-level tool argument injected by the server.

string

setup_url

required

Relative UI route where the user can securely provision the value.

string

tool_name

required

MCP tool whose outbound call receives the credential.

string

updated_at

required

RFC 3339 last-update time.

string

Example

{
  "data": [
    {
      "agent_id": "agent_01933b5a000070008000000000000001",
      "configured": true,
      "created_at": "2026-08-08T16:00:00Z",
      "description": "Delivers scheduled status notifications",
      "id": "01933b5a-0000-7000-8000-000000000001",
      "label": "Visti channel key",
      "mcp_server_name": "visti",
      "mcp_server_url": "https://visti.sh/mcp",
      "parameter_name": "channel_key",
      "setup_url": "/agents/agent_01933b5a000070008000000000000001?tab=credentials",
      "tool_name": "visti_send",
      "updated_at": "2026-08-08T16:05:00Z"
    }
  ]
}