MCP Server

Añade verificación de citas académicas a Claude Desktop, Cursor o cualquier cliente MCP compatible.

@citetrue/mcp-servernpx -y @citetrue/mcp-server

Qué obtienes

Cinco herramientas que envuelven la API REST de CiteTrue. Mismos créditos, misma precisión — solo vía MCP en lugar de HTTP.

Herramienta	Propósito	Créditos / llamada
verify	Split a text blob into references and verify each. `depth` selects accuracy vs. cost.	1 or 5 per ref by depth
get_credits	Devuelve el saldo de créditos de la cuenta.	0

Inicio rápido

Ir a Panel → Claves API y hacer clic en Nueva clave API. Copiar la clave que empieza con sk_.
Abrir la configuración del cliente MCP (ver Configuración del cliente) y añadir el bloque citetrue.
Reiniciar el cliente MCP — no solo el chat, la app entera.
Pedir al asistente "Verifica estas citas: [pegar]". Llamará verify_fast y resumirá.

Configuración del cliente

Cualquier cliente MCP por stdio sirve. A continuación los tres más comunes; otros usan la misma estructura.

Claude Desktop

Recomendado

Instala CiteTrue como extensión de Claude Desktop — sin editar JSON ni configurar Node. El servidor empaquetado se ejecuta con el Node que incluye Claude Desktop.

Descargar para Claude Desktop

Haz doble clic en el archivo descargado (o arrástralo a Ajustes → Extensions) y pega tu clave API cuando se te solicite — se guarda de forma segura en el llavero de tu sistema.

Importante: tras instalar, asegúrate de que la extensión esté habilitada (activada) en Ajustes → Extensions y reinicia Claude Desktop — eso es lo que activa sus herramientas.

O configurar manualmente

Editar ~/Library/Application Support/Claude/claude_desktop_config.json en macOS, %APPDATA%\Claude\claude_desktop_config.json en Windows:

{
  "mcpServers": {
    "citetrue": {
      "command": "npx",
      "args": ["-y", "@citetrue/mcp-server"],
      "env": {
        "CITETRUE_API_KEY": "sk_..."
      }
    }
  }
}

Cursor

En Settings → MCP → Add new MCP server, usar la misma estructura command/args/env que el JSON de Claude Desktop abajo.

Windsurf, Zed, otros

Cualquier cliente MCP stdio funciona — sea cual sea la ruta de config, los tres mismos campos (command, args, env).

Configuración

Variable de entorno	Predeterminado	Notas
CITETRUE_API_KEY	— (Requerido)	Token Bearer del dashboard.
CITETRUE_API_URL	`https://api.citetrue.com`	Sobrescribir para despliegues self-hosted.

Herramientas

verify

Split a free-form text blob into individual references and verify each. depth selects accuracy vs. cost.

Parámetros

Supply exactly one of text, refHash, or taskHash:

text string — raw text containing one or more references. Accepts numbered lists, bullets, blank-line-separated, BibTeX, or in-text prose with author-year citations (when depth ≥ 5). Max 10MB.
refHash string — upgrade a single prior reference to a deeper run. Requires depth ≥ 5 and parentTaskHash.
parentTaskHash string — required when using refHash; the original task that produced the ref.
taskHash string — resume a previously-started task; replays cached state. No re-billing.
depth 1 | 5, optional, default 1 — 1 fast (1 credit/ref); 5 deep (5 credits/ref). 20 exists as a closed-beta tier and is not enabled for public use.
force bool, optional — bypass cached results (forces a fresh run, charges full cost).

Salida

{
  "taskHash": "...",
  "refs": [
    {
      "hash": "a1b2c3...",
      "text": "[1] Vaswani, A., Shazeer, N., Parmar (2017)...",
      "assessment": "authentic",
      "value": {
        "type": "citation",
        "title": "Attention is all you need",
        "authors": ["A Vaswani", "N Shazeer", "N Parmar"],
        "year": 2017,
        "url": "https://..."
      },
      "note": "",
      "notices": [],
      "data": { "depth": 1, "cost": 1 }
    }
  ],
  "cost": 2,
  "balance": 248
}

data.depth is the highest depth that has run on the ref (1 or 5). Clients derive a "deep-verified" flag locally as depth ≥ 5. note is a free-form one-line natural-language explanation in English (intended for end-user display); for programmatic checks, match on notices[] instead.

Assessment values

authentic — paper exists and is the one cited; value contains the matched paper.
unsure— found something but can't confirm; notices and confidence describe why.
inauthentic — definitively not found / fabricated / unrelated.
invalid— input wasn't a citation; pipeline refused to search.
error — verification failed on this ref; data.errors[] lists tokens.
exceeded — credits ran out before this ref ran.

Facturación

1 credit per ref for depth=1, 5 credits per ref for depth=5.

Solución de problemas

If the server fails to start, ensure npx is on PATH and CITETRUE_API_KEY is set.