*MCP › Referencia › CRM › Contactos*

# Buscar contactos por referencia externa

> A partir de una lista de tus referencias, indica cuáles ya existen en Filmo y cuáles no.

`notFound` son las que hay que crear. Es la primitiva de cualquier sincronización: sin ella, la alternativa es una llamada por referencia y deducirlo del 404. NO escribe NADA, aunque sea un POST: la lista de referencias no cabe en una query string.

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

## Argumentos

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `references` | string[] | Sí | Referencias externas que buscar. Al menos una, como máximo 200. |

## Resultado

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

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `contacts` | object[] | Contactos que coincidieron con al menos una referencia. |
| `contacts.id` | string | Identificador del contacto en Filmo. |
| `contacts.name` | string | Nombre del contacto. |
| `contacts.contactNumber` | string | Número del contacto en Filmo. |
| `notFound` | string[] | Referencias que no coincidieron con ningún contacto. Son las que hay que crear. |

*Llamada · filmo_contacts_lookup*

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_contacts_lookup",
    "arguments": {
      "references": [
        "<references>"
      ]
    }
  }
}
```

*Resultado (generado desde el esquema)*

```json
{
  "structuredContent": {
    "data": {
      "contacts": [
        {
          "id": "id_8f2a1c",
          "name": "Example",
          "contactNumber": "<contactNumber>"
        }
      ],
      "notFound": [
        "<notFound>"
      ]
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}
```

## Prompts de ejemplo

*Prompt*

```text
¿Existe ya un contacto con el email ana@example.com?
```

## La misma operación por REST

Esta herramienta ejecuta [`POST /api/v1/contacts/lookup`](https://docs.filmo.io/es/rest-api/endpoint-reference/contacts/look-up-contacts-by-external-reference).

---

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