# witrack-mcp

> Servidor MCP de witrack: el contexto de cada proyecto (estado actual y bitácora), el relevamiento y los tickets, desde la conversación con tu IA.

Latest version **1.3.0** (published 2026-09-24) · UNLICENSED license · 0 weekly downloads

## Install

```sh
npm install witrack-mcp
pnpm add witrack-mcp
yarn add witrack-mcp
bun add witrack-mcp
```

Provides the command `witrack-mcp`.

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 1.3.0 |
| Published | 2026-09-24 |
| First published | 2026-09-23 |
| Weekly downloads | 0 |
| License | UNLICENSED |
| TypeScript types | none |
| Module format | ESM |
| Node | >=18 |
| Dependencies | 1 |
| Unpacked size | 46.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Wigou |
| Maintainers | andrelowigou |
| Keywords | mcp, model-context-protocol, witrack, wigou |

## Links

- npm: https://www.npmjs.com/package/witrack-mcp
- Repository: https://github.com/aabraham86/witrack
- Homepage: https://github.com/aabraham86/witrack#readme
- Issues: https://github.com/aabraham86/witrack/issues
- npm.io page: https://npm.io/package/witrack-mcp

## Dependencies (1)

- [@modelcontextprotocol/sdk](https://npm.io/package/@modelcontextprotocol/sdk.md) ^1.0.0

## Recent versions

- 1.3.0 (latest) — 2026-09-24
- 1.2.0 — 2026-09-23

## README

# witrack-mcp

El servidor MCP de **witrack**. Le da a tu IA el contexto de cada proyecto de
Wigou —dónde está parado hoy y qué se habló en cada sesión—, los documentos del
relevamiento y los tickets.

No hace falta clonar ni compilar nada: se corre con `npx`, que baja la última
versión sola. Las reglas de cómo trabajamos vienen adentro (`REGLAS.md`) y le
llegan a tu IA como instrucciones del servidor, así que se actualizan con el
paquete.

## Configurarlo

Necesitás dos datos: la URL de witrack y tu **API key**, que sacás de witrack en
**Mi perfil y API keys** (tocá tu nombre, abajo a la izquierda) o directo en
`https://witrack.wigou.co/profile?tab=apikeys`. Es personal: lo que subas queda firmado con tu nombre y
respeta tus permisos.

**Claude Desktop** — `claude_desktop_config.json` (Windows: `%APPDATA%\Claude\`,
macOS: `~/Library/Application Support/Claude/`):

```json
{
  "mcpServers": {
    "witrack": {
      "command": "npx",
      "args": ["-y", "witrack-mcp@latest"],
      "env": {
        "WITRACK_API_URL": "https://witrack.wigou.co",
        "WITRACK_API_KEY": "wt_tu_api_key"
      }
    }
  }
}
```

**Claude Code**, desde la terminal, una sola vez (`--scope user` lo deja
disponible en todos tus proyectos, no sólo en la carpeta donde lo corrés):

```bash
claude mcp add witrack --scope user --env WITRACK_API_URL=https://witrack.wigou.co \
  --env WITRACK_API_KEY=wt_tu_api_key -- npx -y witrack-mcp@latest
```

**OpenCode** — en `opencode.json`:

```json
{
  "mcp": {
    "witrack": {
      "type": "local",
      "command": ["npx", "-y", "witrack-mcp@latest"],
      "environment": {
        "WITRACK_API_URL": "https://witrack.wigou.co",
        "WITRACK_API_KEY": "wt_tu_api_key"
      }
    }
  }
}
```

**Cursor** (`.cursor/mcp.json`) usa la misma forma que Claude Desktop.
**VS Code con Copilot** (`.vscode/mcp.json`) también, pero la clave de arriba es
`servers` en lugar de `mcpServers`, y cada servidor lleva `"type": "stdio"`.

## Qué trae

| Herramienta | Para qué |
| --- | --- |
| `reglas_de_contexto` | Las reglas de cómo trabajamos, para los clientes que no muestran las instrucciones del servidor |
| `find_project_space` | Encontrar el proyecto y su `spaceId` |
| `get_project_context` | El estado actual y la bitácora, por tema y con presupuesto de texto |
| `search_project_context` | Buscar un tema sin traer todo |
| `read_functional_page` | Leer un documento, o una versión anterior |
| `list_page_versions` | El historial de un documento |
| `read_attachment_text` | El texto de un PDF, un Word o un .txt del espacio |
| `compare_functional_versions` | Qué cambió entre dos documentos o versiones |
| `add_context_entry` | Subir la sesión: la entrada de bitácora y, si cambió, el estado |
| `edit_context_entry` | Corregir una entrada ya subida |
| `update_context_state` | Reescribir sólo el estado actual |
| `write_functional_document` | Crear o reescribir un documento del relevamiento |
| `discard_context_entry` | Desactivar una entrada que estaba mal de raíz |
| `list_tasks`, `get_task`, `create_task`, `update_task`, `add_comment`, `list_projects` | Los tickets |

## Cómo trabajamos con esto

Está en [`REGLAS.md`](./REGLAS.md): cuándo subir, qué va en la entrada y en el
estado, qué va en el relevamiento y cómo se corrige. Es markdown plano y sirve con
cualquier modelo. Si usás la API sin MCP, leelo en
`https://unpkg.com/witrack-mcp@latest/REGLAS.md`.

## Publicar una versión nueva

La publica sola GitHub Actions al pushear un tag, que tiene que decir la misma
versión que el `package.json`:

```bash
cd witrack-mcp
npm version patch --no-git-tag-version     # o minor / major
git commit -am "chore(mcp): witrack-mcp 1.3.1"
git tag witrack-mcp-v1.3.1
git push && git push origin witrack-mcp-v1.3.1
```

Nadie tiene que actualizar nada: como todos lo corren con `@latest`, la próxima
vez que abran su herramienta ya tienen la versión nueva, con sus reglas.

---
_Source: https://npm.io/package/witrack-mcp · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._