Contacts

Obtener contacto por nombre

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:

{
  "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.

post/tools/contacts_getContactByName

Request

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

Request body

namestring required

Nombre (o fragmento) del contacto a buscar. No puede estar vacío.

Example request

{
  "name": "Acme S.A.S"
}

Response

Primer contacto que coincide con el nombre.

Changes

No recorded changes to this operation across all 1 revision of this API.