Catálogo de herramientas MCP

Esta es la referencia pública de las 52 herramientas que devuelve actualmente el servidor MCP de Brein. La respuesta tools/list del servidor sigue siendo el schema canónico: las tablas siguientes explican el propósito, los argumentos principales y el límite de acción de cada herramienta pública. Todas las herramientas aceptan un argumento opcional workspace. Debe identificar un workspace para el que la credencial esté autorizada; si se omite, se usa el workspace principal de la credencial.

read significa que la herramienta no cambia datos de Brein. write significa que puede cambiar datos del workspace. confirm significa que una persona debe aprobar la acción después de ver la audiencia, el precio o el efecto propuesto. credits significa que la acción puede gastar créditos de contacto.

Cerebro y documentos

Herramienta	Qué hace	Argumentos principales	Acceso
`context_retrieve`	Encuentra el contexto relevante del equipo para una tarea o archivos.	`task`, `files`, `view`, `limit`	read
`context_get`	Lee un topic de contexto y su cuerpo completo.	`topic`, `view`	read
`context_create`	Crea un topic de contexto comercial compartido.	`name`, `title`, `what`, `how`, `content`, `area`	write
`context_update`	Actualiza un topic de contexto y devuelve su nueva versión.	`topic`, `content`, fields, `expected_version`	write
`context_ls`	Lista carpetas y documentos markdown de Cerebro.	`folder`	read
`context_read`	Lee un documento markdown por su ruta.	`path`	read
`context_write`	Crea o reemplaza un documento markdown.	`path`, `content`, `title`	write
`context_search`	Busca documentos de Cerebro por texto.	`q`, `folder`, `limit`	read

context_ls, context_read, context_write y context_search son la vista con forma de documento del mismo almacén de Cerebro que usan las herramientas con forma de topic. Lee un documento antes de reemplazarlo con context_write.

CRM, empresas y personas

Herramienta	Qué hace	Argumentos principales	Acceso
`collection_query`	Lee páginas acotadas de Records de CRM.	`list`, `op`, `collection_id`, `record_id`, `filter`, `limit`, `cursor`	read
`crm_record`	Agrega, actualiza, actualiza en bloque o consulta el historial de Records de CRM.	`action`, `collection_id`, `record_id`, `fields`, `rows`, `limit`, `cursor`	write
`crm_collection`	Crea una Collection de CRM donde guardar contactos.	`action`, `name`, `archetype`, `record_schema`, `stages`	write
`company_search`	Busca en el directorio acotado de empresas sin devolver coordenadas.	`criterion`, `name`, `countries`, `industries`, `headcount`, `limit`	read
`people_search`	Explora personas profesionales enmascaradas dentro del mercado.	`companyName`, `locations`, `industries`, `departments`, `seniorities`, `limit`	read
`people_quote`	Cotiza un grupo seleccionado antes de revelar contactos.	`search`, `count`, `handles`	read · free
`people_acquired`	Lista personas ya reveladas o importadas al workspace.	`q`, `list_id`, `folder_id`, `import_id`, `origen`, `limit`	read
`people_reveal`	Revela las personas cubiertas por una cotización aceptada.	`people`, `quote_token`, `confirm`, `max_credits`, `idempotency_key`	write · credits · confirm
`people_file`	Guarda una persona adquirida en una Collection de CRM.	`record_id`, `collection_id`	write
`people_status`	Cambia el estado de un contacto existente.	`record_id`, `status`	write

Una empresa, una fila de mercado o un resultado de investigación no se convierte automáticamente en un contacto. Usa people_file para una persona que ya fue revelada o importada.

Listas y workspace

Herramienta	Qué hace	Argumentos principales	Acceso
`list_get`	Lee listas, carpetas, criterios, conteos y miembros guardados.	`list_id`, `state`, `offset`	read
`list_save`	Crea, edita, actualiza o descarta resultados de personas.	`list_id`, `name`, `target`, `companies`, `criteria`, `count`, `refresh`	write
`list_quote`	Cotiza las personas de una lista antes de revelarlas.	`list_id`, `member_ids`	read · free
`workspaces`	Lista los workspaces a los que puede acceder la credencial.	`workspace`	read
`usage`	Lee plan, allowance de mercado, créditos de contactos y renovación.	`workspace`	read

list_quote no revela a nadie. La revelación se hace mediante la misma acción confirmada people_reveal.

Mercado

Todas las herramientas de mercado son de lectura. Devuelven resultados acotados y contexto de fuente. No devuelven coordenadas de contacto ni prometen que el mercado sea completo.

Herramienta	Qué hace	Argumentos principales	Acceso
`market_capabilities`	Devuelve operaciones, filtros, enums y límites actuales del mercado.	`workspace`	read · free
`market_search_suppliers`	Busca proveedores candidatos para un producto, territorio o señal.	`query`, `state`, `municipality`, `observed_kind`, `require_contact`, `limit`, `cursor`	read · bounded
`market_get_supplier`	Inspecciona un proveedor mediante su `record_ref` opaco.	`record_ref`	read · bounded
`market_search_opportunities`	Busca oportunidades públicas y su contexto oficial.	`query`, `strategy`, `buyer`, `state`, `actionability`, `published_from`, `published_to`, `limit`, `cursor`	read · bounded
`market_get_opportunity`	Inspecciona una oportunidad y opcionalmente incluye sus adjudicaciones.	`record_ref`, `include_awards`	read · bounded
`market_search_awards`	Busca contratos adjudicados bajo una moneda y alcance de monto explícitos.	`query`, `supplier_rfc`, `supplier_name`, `buyer`, `currency`, `amount_scope`, `from_date`, `to_date`, `limit`, `cursor`	read · bounded
`market_get_supplier_history`	Lee el historial de adjudicaciones de un proveedor conocido.	`supplier_rfc`, `currency`, `amount_scope`, `from_date`, `to_date`, `limit`, `cursor`	read · bounded
`market_aggregate_awards`	Agrega montos de adjudicaciones y compara periodos.	`currency`, `amount_scope`, `group_by`, `order_by`, `from_date`, `to_date`, `compare_period`	read · bounded
`market_search_risks`	Busca marcas publicadas de riesgo o sanción.	`rfc`, `entity_name`, `mark_kind`, `from_date`, `to_date`, `limit`, `cursor`	read · bounded
`market_search_permits`	Busca permisos y concesiones publicadas de energía o minería.	`sector`, `holder_rfc`, `holder_name`, `permit_kind`, `state`, `from_date`, `to_date`	read · bounded
`market_screen_risks`	Revisa hasta 50 RFC conocidos contra listas de riesgo publicadas.	`rfcs`	read · bounded
`market_count_suppliers`	Cuenta proveedores en un segmento de mercado acotado.	`query`, `state`, `municipality`, `observed_kind`, `require_contact`, `contact_kind`	read · bounded
`market_compare_segments`	Compara hasta cinco segmentos en hasta diez territorios.	`segments`, `geographies`, `observed_kind`, `contact_breakdown`	read · bounded

Empieza con market_capabilities cuando no estén claros los filtros o la cobertura. market_search_* devuelve candidatos; market_get_* verifica una referencia devuelta. Los conteos y agregados no devuelven las filas subyacentes.

Campañas y envío

Un borrador de campaña es inerte. Crear, editar, previsualizar o revisar una secuencia no envía emails. La activación y una respuesta puntual requieren confirmación humana explícita.

Herramienta	Qué hace	Argumentos principales	Acceso
`sequence_list`	Lista secuencias salientes en el workspace.	`workspace`	read
`sequence_get`	Lee una secuencia, pasos, audiencia, copy renderizado, sender e historial de autorización.	`sequence_id`	read
`sequence_create_draft`	Crea un borrador inerte desde contactos adquiridos o una audiencia válida.	`name`, `contacts`, `from_people`, `from_collection_id`, `from_list_id`, `sender_mailbox_id`, `schedule`	write
`sequence_update_draft`	Edita una secuencia no enviada o uno de sus pasos.	`sequence_id`, `action`, `name`, `step_number`, `subject`, `message_body`, `wait_days`	write
`sequence_preview`	Renderiza los mensajes exactos y warnings sin enviarlos.	`sequence_id`	read
`sequence_check`	Ejecuta preflight y devuelve readiness, bloqueos, warnings y token de activación.	`sequence_id`	read
`sequence_activate`	Comienza el envío real después de que la persona confirme audiencia y token.	`sequence_id`, `activation_token`, `confirm`, `idempotency_key`	write · sends email · confirm
`sequence_pause`	Detiene próximos envíos conservando la secuencia y el historial.	`sequence_id`	write
`sequence_cancel`	Termina la secuencia y detiene receptores pendientes sin borrar el historial.	`sequence_id`	write
`sequence_metrics`	Lee conteos de entrega y engagement por secuencia.	`sequence_id`	read
`sequence_analytics`	Lee analítica de campañas de todo el workspace.	`workspace`	read
`sequence_reply_thread`	Envía una respuesta escrita por una persona dentro de un hilo.	`sequence_id`, `recipient_id`, `body`, `subject`, `confirm`	write · sends email · confirm
`mailbox_status`	Lee la salud y capacidad diaria del sender sin exponer direcciones.	`workspace`	read
`mailbox_propose_pace`	Prepara una propuesta sellada de límite o ritmo del sender.	`mailbox_id`, `daily_send_limit`, `min_seconds_between_sends`	read
`mailbox_set_pace`	Aplica una propuesta de ritmo después de confirmarla.	`mailbox_id`, `pace_token`, `confirm`, `daily_send_limit`, `min_seconds_between_sends`	write · confirm

Tareas en segundo plano

Herramienta	Qué hace	Argumentos principales	Acceso
`task_start`	Inicia una investigación grande en segundo plano y devuelve un task id.	`title`, `prompt`, `total`	write · background

Usa task_start para investigar muchas empresas o calificar una lista grande. No puede revelar contactos ni enviar emails. Para una solicitud que cabe en una respuesta, usa directamente las herramientas de mercado o empresas.

Cómo usar el catálogo

Lee la descripción y los argumentos principales.
Empieza con una herramienta de lectura.
Confirma el workspace y la audiencia.
Ejecuta la cotización, previsualización o preflight requerida.
Llama la herramienta de escritura o activación sólo después de la confirmación requerida.

La respuesta viva tools/list incluye el schema JSON completo, las anotaciones y los ejemplos actuales. Si esta página y el schema del servidor difieren, el schema del servidor es la autoridad.

Primeros pasos

Trabaja en Brein

Conecta tu IA

Para desarrolladores

Referencia MCP

Catálogo de herramientas MCP

Cerebro y documentos

CRM, empresas y personas

Listas y workspace

Mercado

Campañas y envío

Tareas en segundo plano

Cómo usar el catálogo

​Cerebro y documentos

​CRM, empresas y personas

​Listas y workspace

​Mercado

​Campañas y envío

​Tareas en segundo plano

​Cómo usar el catálogo

Cerebro y documentos

CRM, empresas y personas

Listas y workspace

Mercado

Campañas y envío

Tareas en segundo plano

Cómo usar el catálogo