*MCP › Referencia › CRM › Contactos*

# Listar los contactos relacionados con un contacto

> Devuelve los contactos vinculados a este, en ambos sentidos de la relación, cada uno con el rol de la relación.

El detalle del contacto devuelve la misma lista en `relatedContacts`; este es el subrecurso para leerla por separado.

HERRAMIENTA `filmo_contacts_related_list` · `contacts:read` · 120/min · Anotación del servidor: Solo lectura · Anotación del servidor: Idempotente

## Argumentos

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `contactId` | string | Sí | Identificador del contacto. |

## Resultado

En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`.

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `id` | string | Identificador único del contacto relacionado. |
| `name` | string | Nombre del contacto relacionado. |
| `commercialName` | string | Nombre comercial del contacto relacionado; null si no consta. |
| `contactType` | string | Tipo del contacto relacionado: person o company. `person`, `company` |
| `role` | string | Rol del contacto relacionado. `client`, `provider`, `lead`, `debtor`, `creditor`, `student`, `teacher`, `unspecified` |
| `status` | string | Estado del contacto relacionado: active, inactive o archived. `active`, `inactive`, `archived` |
| `relationRole` | string | Rol de la relación entre los dos contactos (p. ej. "empleado de"); null si no consta. |

*Llamada · filmo_contacts_related_list*

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_contacts_related_list",
    "arguments": {
      "contactId": "cont_8f2a1c"
    }
  }
}
```

*Resultado (generado desde el esquema)*

```json
{
  "structuredContent": {
    "data": [
      {
        "id": "id_8f2a1c",
        "name": "Example",
        "commercialName": "Example",
        "contactType": "person",
        "role": "client",
        "status": "active",
        "relationRole": "<relationRole>"
      }
    ],
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      },
      "etag": "\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
    }
  }
}
```

## La misma operación por REST

Esta herramienta ejecuta [`GET /api/v1/contacts/{contactId}/related-contacts`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/list-the-contacts-related-to-a-contact).

---

URL canónica: https://docs.filmo.io/es/mcp/tools/contacts/filmo-contacts-related-list  
Última actualización: 2026-10-25