---
title: "Listar vendedores"
method: POST
path: "/tools/sellers_getSellers"
tags: ["Sellers"]
---

# Listar vendedores

`POST /tools/sellers_getSellers`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/sellers_getSellers`
- Auth: HTTP bearer

Herramienta MCP: `sellers_getSellers`.

Devuelve la lista de vendedores de la compañía, con paginación y, opcionalmente, metadatos del resultado.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "sellers_getSellers",
    "arguments": { "start": 0, "limit": 30 }
  }
}
```

Paginación con `start` (desplazamiento desde 0; úsalo junto con `limit`) y `limit` (cantidad máxima de vendedores por página; por defecto 30). Con `metadata: true` la respuesta incluye metadatos como el total de vendedores.

Úsala para descubrir los vendedores disponibles en la compañía.

Solo lectura.

## Request body

- object
  - `limit` integer: Cantidad máxima de vendedores a devolver por página. Por defecto 30.
  - `start` integer: Desplazamiento de paginación (desde 0). Úsalo junto con `limit` para recorrer los resultados.
  - `metadata` boolean: Incluye metadatos de la respuesta, como el total de vendedores.

## Response `200`

Lista de vendedores

## Other responses

- `401`: No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)