# Herramientas Tu agente puede usar 30 herramientas. Esta referencia se genera desde el código del servidor, así que no se desfasa de lo que el servidor ofrece. ## Herramientas de lectura (18) Funcionan con cualquier token y no cambian nada. - [`get_visibility_summary`](https://docs.bisonagents.com/mcp/herramientas/get_visibility_summary/): Visibilidad de la marca en la última semana medida: puntaje general, tasa de mención, share of voice, citas, sentimiento, puntaje por modelo y variación contra la semana anterior, y posición frente a los competidores. - [`compare_competitors`](https://docs.bisonagents.com/mcp/herramientas/compare_competitors/): Tabla de la marca y sus competidores en la última semana, ordenada por share of voice. Sirve para ver quién aparece más que la marca y en qué modelo. - [`get_top_sources`](https://docs.bisonagents.com/mcp/herramientas/get_top_sources/): Páginas que los modelos consultaron o citaron al responder las preguntas de la marca en la última semana, las más citadas primero, con las marcas que aparecen en cada una y si es el sitio propio. - [`list_prompts`](https://docs.bisonagents.com/mcp/herramientas/list_prompts/): Preguntas de compra que Bison le hace cada semana a los asistentes de IA para esta marca, de mayor a menor prioridad. priority: nivel (high, medium, low), puntaje 0–100, recomendación (keep seguir, review revisar, replace cambiar) y razones con su fuente. - [`list_prompt_suggestions`](https://docs.bisonagents.com/mcp/herramientas/list_prompt_suggestions/): Preguntas sugeridas que todavía no se monitorean, de mayor a menor prioridad, con las razones de cada una. Sirven para elegir qué agregar o con qué reemplazar una pregunta marcada replace. - [`list_improvements`](https://docs.bisonagents.com/mcp/herramientas/list_improvements/): Acciones recomendadas por Bison para mejorar la visibilidad, por prioridad, con impacto, esfuerzo y pasos. Cada una trae su jugada de la metodología (play, family), nivel, cuadrante, estado del entregable, plan y fecha de verificación. - [`get_visibility_trend`](https://docs.bisonagents.com/mcp/herramientas/get_visibility_trend/): Puntaje mensual de visibilidad (total y por modelo) y la línea base desde que la marca empezó. - [`get_prompt_detail`](https://docs.bisonagents.com/mcp/herramientas/get_prompt_detail/): Una pregunta monitoreada a fondo: puntaje total y por modelo, variación semanal, historial, extracto de cómo respondió cada modelo, marcas que aparecen y páginas que consultó. Usa list_prompts para obtener el id. - [`compare_weeks`](https://docs.bisonagents.com/mcp/herramientas/compare_weeks/): Compara dos semanas medidas: métricas total y por modelo, share of voice de cada competidor y las preguntas que más subieron o bajaron. Sin argumentos compara la última semana con la anterior. - [`get_technical_audit`](https://docs.bisonagents.com/mcp/herramientas/get_technical_audit/): Último resultado de cada auditoría técnica que afecta a los rastreadores de IA: robots.txt, llms.txt, sitemap, HTTPS, semántica on-page, Core Web Vitals y rastreo de enlaces, con puntaje y problemas. - [`get_schema_status`](https://docs.bisonagents.com/mcp/herramientas/get_schema_status/): Cobertura de datos estructurados (Schema.org) de las páginas monitoreadas, peor puntaje primero, con tipos presentes, si hay schema generado e implementado, y recomendaciones. - [`get_brand_profile`](https://docs.bisonagents.com/mcp/herramientas/get_brand_profile/): Base de conocimiento de la marca resumida: identidad, voz y reglas de estilo, productos, audiencias, datos duros y operación, con el id de cada producto y audiencia. missing lista los datos clave que faltan (sin ellos Bison no puede dar algunas recomendaciones). Úsalo antes de escribir contenido en nombre de la marca. - [`get_task_brief`](https://docs.bisonagents.com/mcp/herramientas/get_task_brief/): Convierte una mejora recomendada en un brief Markdown autocontenido (contexto, pasos, competidores, auditoría y criterio de término) para que otro agente lo ejecute. Usa list_improvements para el id. - [`list_faqs`](https://docs.bisonagents.com/mcp/herramientas/list_faqs/): FAQs de la marca preparadas para IA (pregunta, respuesta, si está publicada y qué datos faltan), más nuevas primero. - [`get_monthly_report`](https://docs.bisonagents.com/mcp/herramientas/get_monthly_report/): Reporte mensual publicado: resumen ejecutivo, recomendaciones, oportunidades y hoja de ruta. Sin period devuelve el más reciente. - [`get_ai_traffic`](https://docs.bisonagents.com/mcp/herramientas/get_ai_traffic/): Sesiones que llegan al sitio desde asistentes de IA según Google Analytics 4 (últimos 28 días contra los 28 anteriores), por asistente y con conversiones si hay ecommerce. Requiere GA4 conectado en Bison. - [`list_competitors`](https://docs.bisonagents.com/mcp/herramientas/list_competitors/): Competidores que la marca tiene configurados en Bison, con su id, dominios, alias, tipo y estado. Para cómo les va en las respuestas de la IA, usa compare_competitors. - [`get_job_status`](https://docs.bisonagents.com/mcp/herramientas/get_job_status/): Estado de un trabajo iniciado por run_schema_audit, generate_faqs o regenerate_improvements cuando respondieron con status running. ## Herramientas de edición (9) Solo con un token de «Lectura y edición». Cambian datos de tu empresa en Bison. - [`update_improvement`](https://docs.bisonagents.com/mcp/herramientas/update_improvement/): Cambia el estado de una mejora recomendada (done = hecha, dismissed = descartada, pending = reabrir) y/o marca pasos como hechos por su índice (0 = primero). Queda registrado como hecho por este token. - [`suggest_prompt`](https://docs.bisonagents.com/mcp/herramientas/suggest_prompt/): Deja una pregunta de compra en las sugerencias de Bison (Prompts → Sugerencias). No se monitorea ni cuesta nada hasta que alguien del equipo la acepta. - [`create_prompt`](https://docs.bisonagents.com/mcp/herramientas/create_prompt/): Agrega una pregunta de compra al monitoreo semanal de la marca, dentro del límite de preguntas activas del plan; la vista previa dice cuántas quedan. Ocupa un cupo y se mide desde la próxima corrida. Rechaza una pregunta que ya se monitorea. Sin confirm devuelve la vista previa; muéstrala al usuario antes de crearla. - [`archive_prompt`](https://docs.bisonagents.com/mcp/herramientas/archive_prompt/): Deja de medir una pregunta de la marca (id de list_prompts). Conserva su historial, libera un cupo del plan y Bison recalcula el reporte de la empresa. Sin confirm devuelve la vista previa. - [`accept_prompt_suggestion`](https://docs.bisonagents.com/mcp/herramientas/accept_prompt_suggestion/): Convierte una sugerencia (id de list_prompt_suggestions) en pregunta monitoreada y la quita de las sugerencias, como Prompts → Sugerencias en Bison. Respeta el límite del plan: si no hay cupo, la sugerencia queda. Sin confirm devuelve la vista previa. - [`save_competitor`](https://docs.bisonagents.com/mcp/herramientas/save_competitor/): Crea un competidor de la marca, dentro del límite de competidores del plan, o edita uno existente por su id (de list_competitors). Para crear, name y website_url son obligatorios. Al editar, solo cambian los campos enviados; una lista reemplaza a la guardada. Los alias sirven para reconocer menciones con otro nombre y cuentan desde la próxima corrida semanal. Sin confirm devuelve la vista previa. - [`update_brand_profile`](https://docs.bisonagents.com/mcp/herramientas/update_brand_profile/): Completa o corrige el perfil de marca (Bison → Conocimiento): resumen, voz, ficha de datos y operación. Envía solo los campos que cambian; el resto queda igual y una lista reemplaza a la guardada. Los campos marcados «Clave» son los que get_brand_profile lista en missing cuando faltan. Productos y audiencias se editan con save_product y save_audience. Sin confirm devuelve la vista previa; muéstrala al usuario antes de guardar. - [`save_product`](https://docs.bisonagents.com/mcp/herramientas/save_product/): Crea un producto o servicio del perfil de marca, o edita uno existente por su id (de get_brand_profile). Para crear, name es obligatorio. Solo cambia los campos enviados; los demás productos y las categorías quedan igual, y una categoría nueva se agrega a la lista. Sin confirm devuelve la vista previa. - [`save_audience`](https://docs.bisonagents.com/mcp/herramientas/save_audience/): Crea una audiencia del perfil de marca, o edita una existente por su id (de get_brand_profile). Para crear, name es obligatorio. Solo cambia los campos enviados. Sin confirm devuelve la vista previa. ## Trabajos con costo (3) Solo con un token de «Lectura y edición». Inician un trabajo que consume recursos de Bison. - [`run_schema_audit`](https://docs.bisonagents.com/mcp/herramientas/run_schema_audit/): Audita los datos estructurados de una página del sitio de la marca y guarda el resultado en Bison. Tiene costo: confirma con el usuario antes. - [`generate_faqs`](https://docs.bisonagents.com/mcp/herramientas/generate_faqs/): Genera FAQs nuevas a partir de las preguntas monitoreadas y las guarda como borrador en Bison. Tiene costo y puede tardar minutos: confirma con el usuario antes. - [`regenerate_improvements`](https://docs.bisonagents.com/mcp/herramientas/regenerate_improvements/): Vuelve a calcular las mejoras recomendadas con los últimos reportes (crea, actualiza y resuelve). Tiene costo: confirma con el usuario antes.