---
title: "List skills (list_skills)"
method: GET
path: "/sdk/agents/{agentId}/skills"
tags: ["SDK — Skills"]
---

# List skills (list_skills)

`GET /sdk/agents/{agentId}/skills`

## Request

- Base URL: `https://api.agentbrink.com/api`
- URL: `https://api.agentbrink.com/api/sdk/agents/{agentId}/skills`
- Auth: HTTP bearer

## Response `200`

OK

- Skill[]
  - `_id` string
  - `name` string
  - `description` string
  - `parameters` SkillParameter[]
    - `name` string, required
    - `type` 'string' | 'number' | 'boolean' | 'object' | 'array', required
    - `description` string, required
    - `required` boolean
  - `handler` SkillHandler
    - `type` 'webhook' | 'mcp', required
    - `webhookUrl` string: For webhook handlers: URL to POST to
    - `webhookHeaders` object: Optional extra headers for webhook calls
    - `mcpServerUrl` string: For MCP handlers: HTTP base URL of the MCP server
    - `mcpToolName` string: For MCP handlers: tool name to call on the MCP server
  - `enabled` boolean
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `401`: Missing or invalid Bearer token

---

[API](https://skmtc.dev/agentbrink/apis/agentbrink-api.md) · [All operations](https://skmtc.dev/agentbrink/apis/agentbrink-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentbrink/apis/agentbrink-api/revisions/d2c782056161?raw)