<!-- https://docs.bisonagents.com/mcp/ -->

# MCP de Bison

Conecta Claude, Cursor u otro agente compatible con MCP a tu cuenta de Bison. Tu agente consulta tu visibilidad en asistentes de IA, tus competidores, las fuentes que citan los modelos y tus mejoras pendientes, sin que salgas de tu herramienta.

## Qué puedes hacer

- Ver cómo apareció tu marca esta semana en ChatGPT, Gemini, Perplexity y Claude, y qué cambió contra la semana anterior.
- Entender por qué subió o cayó tu visibilidad, pregunta por pregunta.
- Compararte con tus competidores y ver qué fuentes citan los modelos.
- Revisar tus mejoras recomendadas y pedir el brief de cada una.
- Con permiso de edición: marcar mejoras como hechas, sugerir preguntas y lanzar auditorías de schema o generación de FAQs, que tienen costo.

## Empieza en tres pasos

- [Crea un token](https://docs.bisonagents.com/mcp/tokens/): Desde Ajustes → API y agentes. Elige solo lectura o lectura y edición.
- [Conecta tu agente](https://docs.bisonagents.com/mcp/conectar/): Copia la configuración de tu cliente y pega tu token.
- [Pregunta](https://docs.bisonagents.com/mcp/herramientas/): Pídele a tu agente lo que quieras saber; él elige la herramienta.

## Preguntas para probar

- «¿Cómo estuvo mi visibilidad en IA esta semana y qué cambió?»
- «¿Por qué bajó mi mención en ChatGPT?»
- «¿Qué competidor aparece más que yo y en qué fuentes?»
- «Dame las tres mejoras con más impacto y el brief de la primera.»

## Qué datos ve tu agente

Cada token pertenece a una empresa y solo lee, y si tiene permiso de edición solo escribe, los datos de esa empresa. Los porcentajes van de 0 a 100 y un valor `null` significa sin datos, no cero.

## Datos técnicos

| Dato | Valor |
| --- | --- |
| URL del servidor | `https://mcp.bisonagents.com` |
| Protocolo | MCP sobre HTTP, con respuestas JSON y sin sesión |
| Autenticación | Encabezado `Authorization: Bearer bsn_…` con un token de tu empresa |
| Servidor | `bison`, versión 2.0.0 |
| Contenido | 22 herramientas, 3 prompts y 4 recursos |

---

<!-- https://docs.bisonagents.com/mcp/conectar/ -->

# Conectar tu agente

Necesitas un token (mira [Tokens y permisos](https://docs.bisonagents.com/mcp/tokens/)). En cada configuración reemplaza `bsn_TU_TOKEN` por el tuyo. La URL del servidor es `https://mcp.bisonagents.com`.

> **Cuida tu token:** Trátalo como una contraseña: no lo pegues en chats, repositorios ni capturas. Si se filtra, revócalo desde Ajustes y crea otro.

## Claude Code

Ejecuta este comando en tu terminal:

```bash
claude mcp add --transport http bison https://mcp.bisonagents.com --header "Authorization: Bearer bsn_TU_TOKEN"
```

## Cursor

Agrégalo en `~/.cursor/mcp.json` (o `.cursor/mcp.json` dentro de un proyecto):

```json
{
  "mcpServers": {
    "bison": {
      "url": "https://mcp.bisonagents.com",
      "headers": {
        "Authorization": "Bearer bsn_TU_TOKEN"
      }
    }
  }
}
```

## VS Code

Agrégalo en `.vscode/mcp.json`. La clave raíz es `servers`, no `mcpServers`:

```json
{
  "servers": {
    "bison": {
      "type": "http",
      "url": "https://mcp.bisonagents.com",
      "headers": {
        "Authorization": "Bearer bsn_TU_TOKEN"
      }
    }
  }
}
```

## Claude Desktop

En Ajustes → Conectores → Agregar conector personalizado, pega la URL y, si ves «Encabezados de solicitud», agrega `Authorization` con el valor de abajo. Si no aparece esa sección, usa este puente en `claude_desktop_config.json`:

```text
URL: https://mcp.bisonagents.com
Authorization: Bearer bsn_TU_TOKEN

{
  "mcpServers": {
    "bison": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.bisonagents.com",
        "--header",
        "Authorization:${BISON_AUTH}"
      ],
      "env": {
        "BISON_AUTH": "Bearer bsn_TU_TOKEN"
      }
    }
  }
}
```

## Gemini CLI

Ejecuta este comando en tu terminal:

```bash
gemini mcp add --transport http --header "Authorization: Bearer bsn_TU_TOKEN" bison https://mcp.bisonagents.com
```

## Codex

Guarda el token en una variable de entorno (`BISON_TOKEN`) y agrégalo en `~/.codex/config.toml`:

```toml
[mcp_servers.bison]
url = "https://mcp.bisonagents.com"
bearer_token_env_var = "BISON_TOKEN"

# export BISON_TOKEN=bsn_TU_TOKEN
```

## ChatGPT

Por ahora no hay configuración para ChatGPT: sus conectores personalizados solo aceptan OAuth, que Bison todavía no ofrece. Mientras tanto usa alguno de los clientes de arriba.

## Comprobar la conexión

Con `curl` puedes pedir la lista de herramientas. Si tu token es válido, responde con un JSON que las enumera:

```bash
curl -s https://mcp.bisonagents.com \
  -H "Authorization: Bearer bsn_TU_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

Si algo falla, revisa [Límites y errores](https://docs.bisonagents.com/mcp/limites-y-errores/): ahí está cada respuesta posible y qué hacer.

---

<!-- https://docs.bisonagents.com/mcp/tokens/ -->

# Tokens y permisos

Un token le da a tu agente acceso a los datos de tu empresa. Cada uno tiene un nombre y un permiso, y puedes revocarlo cuando quieras.

## Crear un token

Solo los dueños y administradores de la empresa pueden crear tokens.

1. En Bison, entra a **Ajustes → API y agentes**.
2. Pulsa **Crear token**.
3. Ponle un nombre que diga dónde lo vas a usar, para reconocerlo después.
4. Elige el permiso: **Solo lectura** o **Lectura y edición**.
5. Copia el token. No se vuelve a mostrar: si lo pierdes, crea otro y revoca este.

Los tokens empiezan con `bsn_`. De cada uno Bison guarda solo una huella, nunca el token completo.

## Permisos

| Permiso | Qué puede hacer | Herramientas |
| --- | --- | --- |
| Solo lectura | Consultar tu visibilidad, competidores, fuentes, preguntas, mejoras, auditorías y reportes. | 17 |
| Lectura y edición | Todo lo anterior, más cambiar el estado de mejoras, sugerir preguntas y lanzar trabajos con costo (auditoría de schema, FAQs y recálculo de mejoras). | 22 |

> **Elige el permiso mínimo:** Usa solo lectura salvo que de verdad necesites que tu agente cambie datos o lance trabajos. Con edición, el servidor le indica a tu agente que pida tu confirmación antes de usar una herramienta que cambia datos o tiene costo.

Mira la lista completa, con el permiso de cada una, en [Herramientas](https://docs.bisonagents.com/mcp/herramientas/).

## Buenas prácticas

- Crea un token por herramienta o por persona, con un nombre que diga dónde se usa. Así puedes revocar uno sin cortar los demás.
- No lo guardes en repositorios, chats ni documentos compartidos. Usa variables de entorno o el gestor de secretos de tu cliente.
- Si sospechas que se filtró, revócalo de inmediato.

## Revocar un token

En la tabla de tokens de **Ajustes → API y agentes**, revoca el que ya no uses. Desde ese momento, el agente que lo tenga recibe un error 401.

Cada empresa puede tener hasta 10 tokens activos a la vez. Revoca uno antes de crear otro.

---

<!-- https://docs.bisonagents.com/mcp/herramientas/ -->

# Herramientas

Tu agente puede usar 22 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 (17)

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. Ú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.
- [`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 (2)

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.

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

---

<!-- https://docs.bisonagents.com/mcp/herramientas/get_visibility_summary/ -->

# Resumen de visibilidad en IA

`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.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

Esta herramienta no recibe parámetros.

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_visibility_summary",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/compare_competitors/ -->

# Comparar con competidores

`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.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `model` | una de `total`, `chatgpt`, `claude`, `gemini`, `perplexity` | No | Modelo a comparar; total (todos) por defecto. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "compare_competitors",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/get_top_sources/ -->

# Fuentes que usan las IA

`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.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `limit` | entero (1 a 50) | No | Cantidad de fuentes; 15 por defecto. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_top_sources",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/list_prompts/ -->

# Preguntas monitoreadas

`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.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `limit` | entero (1 a 200) | No | Máximo de preguntas; 50 por defecto. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_prompts",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/list_prompt_suggestions/ -->

# Preguntas sugeridas

`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.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `limit` | entero (1 a 100) | No | Máximo de sugerencias; 30 por defecto. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_prompt_suggestions",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/list_improvements/ -->

# Mejoras recomendadas

`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.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `status` | una de `pending`, `done`, `dismissed`, `resolved`, `all` | No | Estado a listar; pending por defecto. |
| `limit` | entero (1 a 50) | No | Máximo de mejoras; 10 por defecto. |
| `play` | texto | No | Jugada de la metodología, p. ej. CON-06. |
| `family` | texto | No | Familia: IDE, TEC, CON, AUT, REP, PRE, COM o MED. |
| `format` | una de `task`, `plan` | No | task (tarea suelta) o plan (paso de un plan). |
| `level_min` | entero (1 a 5) | No | Nivel mínimo (3: con datos de la marca; 4: con entregable). |
| `quadrant` | una de `quick_win`, `bet`, `incremental`, `questionable` | No | Cuadrante impacto × esfuerzo. |
| `plan_id` | texto | No | Solo los pasos de este plan. |
| `deliverable_status` | una de `pending`, `ready`, `stale` | No | Estado del entregable: pending (en preparación), ready o stale. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_improvements",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/get_visibility_trend/ -->

# Evolución de la visibilidad

`get_visibility_trend`

Puntaje mensual de visibilidad (total y por modelo) y la línea base desde que la marca empezó.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `months` | entero (1 a 24) | No | Meses hacia atrás; 6 por defecto. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_visibility_trend",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/get_prompt_detail/ -->

# Detalle de una pregunta

`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.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `prompt_id` | texto | Sí | id de list_prompts. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_prompt_detail",
    "arguments": {
      "prompt_id": "<prompt_id>"
    }
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/compare_weeks/ -->

# Comparar dos semanas

`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.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `week` | texto | No | Fecha YYYY-MM-DD dentro de la semana (se usa la semana medida más cercana hacia atrás). |
| `compare_to` | texto | No | Fecha YYYY-MM-DD dentro de la semana (se usa la semana medida más cercana hacia atrás). |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "compare_weeks",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/get_technical_audit/ -->

# Auditoría técnica del sitio

`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.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

Esta herramienta no recibe parámetros.

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_technical_audit",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/get_schema_status/ -->

# Estado de Schema.org

`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.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `limit` | entero (1 a 100) | No | Páginas; 20 por defecto. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_schema_status",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/get_brand_profile/ -->

# Perfil de marca

`get_brand_profile`

Base de conocimiento de la marca resumida: identidad, voz y reglas de estilo, productos, audiencias, datos duros y operación. Úsalo antes de escribir contenido en nombre de la marca.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

Esta herramienta no recibe parámetros.

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_brand_profile",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/get_task_brief/ -->

# Brief de una mejora

`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.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `improvement_id` | texto | Sí | id de list_improvements. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_task_brief",
    "arguments": {
      "improvement_id": "<improvement_id>"
    }
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/list_faqs/ -->

# Preguntas frecuentes

`list_faqs`

FAQs de la marca preparadas para IA (pregunta, respuesta, si está publicada y qué datos faltan), más nuevas primero.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `status` | texto | No | Filtrar por estado exacto (p. ej. active). |
| `limit` | entero (1 a 100) | No | Máximo; 20 por defecto. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_faqs",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/get_monthly_report/ -->

# Reporte mensual

`get_monthly_report`

Reporte mensual publicado: resumen ejecutivo, recomendaciones, oportunidades y hoja de ruta. Sin period devuelve el más reciente.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `period` | texto | No | Mes YYYY-MM. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_monthly_report",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/get_ai_traffic/ -->

# Tráfico desde IA

`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.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

Esta herramienta no recibe parámetros.

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_ai_traffic",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/get_job_status/ -->

# Estado de un trabajo

`get_job_status`

Estado de un trabajo iniciado por run_schema_audit, generate_faqs o regenerate_improvements cuando respondieron con status running.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `job_id` | texto | Sí | jobId de run_schema_audit, generate_faqs o regenerate_improvements. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_job_status",
    "arguments": {
      "job_id": "<job_id>"
    }
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/update_improvement/ -->

# Actualizar una mejora

`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.

**Permiso:** Edición. Requiere un token de «Lectura y edición».

> **Cambia datos:** Modifica información de tu empresa en Bison. Tu agente debería pedirte confirmación antes de usarla.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `improvement_id` | texto | Sí | id de list_improvements. |
| `status` | una de `pending`, `done`, `dismissed` | No | — |
| `steps_done` | lista | No | Índices de pasos a marcar como hechos. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_improvement",
    "arguments": {
      "improvement_id": "<improvement_id>"
    }
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/suggest_prompt/ -->

# Sugerir una pregunta

`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.

**Permiso:** Edición. Requiere un token de «Lectura y edición».

> **Cambia datos:** Modifica información de tu empresa en Bison. Tu agente debería pedirte confirmación antes de usarla.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `prompt` | texto | Sí | La pregunta, como la haría un comprador. |
| `category` | texto | No | — |
| `subcategory` | texto | No | — |
| `rationale` | texto | No | Por qué conviene monitorearla. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "suggest_prompt",
    "arguments": {
      "prompt": "<prompt>"
    }
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/run_schema_audit/ -->

# Auditar Schema.org de una página

`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.

**Permiso:** Trabajo con costo. Requiere un token de «Lectura y edición».

> **Tiene costo:** Inicia un trabajo que consume recursos de Bison. Hay un tope de 30 por día y por empresa (día UTC). Si el trabajo sigue corriendo al responder, consulta su avance con [get_job_status](https://docs.bisonagents.com/mcp/herramientas/get_job_status/).

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `url` | texto | Sí | — |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run_schema_audit",
    "arguments": {
      "url": "<url>"
    }
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/generate_faqs/ -->

# Generar FAQs

`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.

**Permiso:** Trabajo con costo. Requiere un token de «Lectura y edición».

> **Tiene costo:** Inicia un trabajo que consume recursos de Bison. Hay un tope de 3 por día y por empresa (día UTC). Si el trabajo sigue corriendo al responder, consulta su avance con [get_job_status](https://docs.bisonagents.com/mcp/herramientas/get_job_status/).

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `language` | una de `Spanish`, `English`, `Portuguese` | No | Idioma; Spanish por defecto. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_faqs",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/herramientas/regenerate_improvements/ -->

# Regenerar mejoras

`regenerate_improvements`

Vuelve a calcular las mejoras recomendadas con los últimos reportes (crea, actualiza y resuelve). Tiene costo: confirma con el usuario antes.

**Permiso:** Trabajo con costo. Requiere un token de «Lectura y edición».

> **Tiene costo:** Inicia un trabajo que consume recursos de Bison. Hay un tope de 3 por día y por empresa (día UTC). Si el trabajo sigue corriendo al responder, consulta su avance con [get_job_status](https://docs.bisonagents.com/mcp/herramientas/get_job_status/).

## Parámetros

Esta herramienta no recibe parámetros.

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "regenerate_improvements",
    "arguments": {}
  }
}
```

---

<!-- https://docs.bisonagents.com/mcp/prompts-y-recursos/ -->

# Prompts y recursos

Además de las herramientas, el servidor ofrece flujos listos para usar y documentos que tu agente puede adjuntar como contexto.

## Prompts

Un prompt es un flujo de trabajo que eliges desde el menú de tu cliente. Solo le indica al agente qué herramientas encadenar; los datos siempre salen de las herramientas. En Claude Code aparecen como `/mcp__bison__<nombre>`.

### Revisión semanal

`revision_semanal`: Resumen de la semana en IA: qué cambió, por qué y las tres acciones que más importan.

No recibe argumentos.

### Explicar una caída

`explicar_caida`: Investiga por qué bajó la visibilidad (en general, en un modelo o en una pregunta).

- `foco` (opcional): un modelo (chatgpt, gemini, perplexity, claude) o el texto de una pregunta.

### Brief de un competidor

`brief_competidor`: Qué hace un competidor para aparecer en las respuestas de IA y cómo responder.

- `competidor` (obligatorio): Dominio o nombre del competidor, como aparece en compare_competitors.

## Recursos

Un recurso es un documento que puedes adjuntar como contexto sin una llamada a herramienta. Tienen el mismo contenido que la herramienta equivalente.

| Recurso | URI | Descripción |
| --- | --- | --- |
| Perfil de marca | `bison://brand/profile` | Identidad, voz, productos, audiencias y datos de la marca (como get_brand_profile). |
| Visibilidad de la última semana | `bison://visibility/latest` | Resumen de visibilidad en IA de la última semana medida (como get_visibility_summary). |
| Último reporte mensual | `bison://reports/latest` | El reporte mensual publicado más reciente (como get_monthly_report). |
| Auditoría técnica | `bison://audit/technical` | Último resultado de cada auditoría técnica del sitio (como get_technical_audit). |

---

<!-- https://docs.bisonagents.com/mcp/limites-y-errores/ -->

# Límites y errores

Qué topes tiene el MCP y cómo se ve cada error, para saber rápido qué corregir.

## Límites

| Qué | Límite |
| --- | --- |
| Tokens activos por empresa | 10 |
| [`run_schema_audit`](https://docs.bisonagents.com/mcp/herramientas/run_schema_audit/) | 30 por día |
| [`generate_faqs`](https://docs.bisonagents.com/mcp/herramientas/generate_faqs/) | 3 por día |
| [`regenerate_improvements`](https://docs.bisonagents.com/mcp/herramientas/regenerate_improvements/) | 3 por día |

Los topes de los trabajos con costo se cuentan por empresa y por día UTC, sumando todos los tokens. Si ya hay un trabajo igual en curso, el servidor devuelve ese en vez de iniciar otro. Los trabajos que tardan responden con estado `running`: consulta su avance con [get_job_status](https://docs.bisonagents.com/mcp/herramientas/get_job_status/).

## Errores de conexión

| Respuesta | Qué significa | Qué hacer |
| --- | --- | --- |
| 401 `UNAUTHENTICATED` | El token falta, está mal escrito o fue revocado. | Revisa que el encabezado sea `Authorization: Bearer bsn_…` y que el token siga activo en Ajustes → API y agentes. |
| 403 `PLAN_REQUIRED` | La cuenta de esa empresa no tiene el MCP habilitado. | Escríbenos para activarlo. |
| 405 | Usaste GET. El servidor no guarda sesiones ni abre un flujo de eventos. | Haz solo peticiones POST a `https://mcp.bisonagents.com`. |
| 406 | Faltó el encabezado `Accept`. | Envía `Accept: application/json, text/event-stream`. Los clientes MCP ya lo hacen. |
| 500 | Falló algo en el servidor. | Reintenta. Si persiste, escríbenos con la hora aproximada. |

## Errores de una herramienta

Cuando una herramienta no puede hacer lo pedido, responde con un mensaje en español y la marca de error, para que tu agente te lo explique. Los más comunes:

- **Tope diario alcanzado.** Dice cuántos trabajos de ese tipo permite el día. Vuelve a intentarlo mañana (UTC) o hazlo desde Bison.
- **Página que no es del sitio de la marca.** `run_schema_audit` solo audita páginas del sitio de tu marca.
- **Pregunta ya monitoreada o ya sugerida.** `suggest_prompt` no duplica preguntas.
- **Demasiadas sugerencias pendientes.** Pide al equipo revisarlas en Bison → Prompts.
- **Mejora que no existe.** `update_improvement` solo cambia mejoras de tu empresa; usa un id de `list_improvements`.

> **Sin datos todavía:** Si tu marca aún no tiene semanas medidas, las herramientas que dependen de un reporte responden con un aviso en lugar de devolver ceros.