---
title: "Obtener contacto por nombre"
method: POST
path: "/tools/contacts_getContactByName"
tags: ["Contacts"]
---

# Obtener contacto por nombre

`POST /tools/contacts_getContactByName`

## Request

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

Herramienta MCP: `contacts_getContactByName`.

Busca un contacto por su nombre y retorna los datos del primer resultado encontrado. Requiere un `name` no vacío.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "contacts_getContactByName",
    "arguments": { "name": "Acme S.A.S" }
  }
}
```

Úsala cuando ya conoces el nombre del contacto y quieres sus datos directamente. Para búsquedas más amplias o exactas, usa `contacts_getContacts` con `query` (texto libre sobre nombre, identificación, email, etc.) o `identification` (coincidencia exacta de documento). Si hay varias coincidencias y necesitas la lista completa, `contacts_getContacts` también es la herramienta adecuada.

Solo lectura.

## Request body

- object
  - `name` string, required: Nombre (o fragmento) del contacto a buscar. No puede estar vacío.

## Response `200`

Primer contacto que coincide con el nombre.

## 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)