CiteTrue Logo

MCP Server

Markdown (per LLM)

Aggiunge la verifica di citazioni accademiche a Claude Desktop, Cursor o qualsiasi client MCP.

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

Cosa ottieni

Cinque strumenti che incapsulano l'API REST CiteTrue. Stessi crediti, stessa precisione — solo via MCP invece di HTTP.

StrumentoScopoCrediti / chiamata
verifySplit a text blob into references and verify each. depth selects accuracy vs. cost.1 or 5 per ref by depth
get_creditsRitorna il saldo crediti del conto.0

Avvio rapido

  1. Andare su Dashboard → Chiavi API e cliccare Nuova chiave API. Copiare la chiave che inizia con sk_.
  2. Aprire la config del client MCP (vedi Configurazione client) e aggiungere il blocco citetrue.
  3. Riavviare il client MCP — non solo la chat, l'intera app.
  4. Chiedere all'assistente "Verifica queste citazioni: [incolla]". Chiamerà verify_fast e riassumerà.

Configurazione client

Qualsiasi client MCP stdio funziona. Sotto i tre più comuni; altri usano la stessa struttura.

Claude Desktop

Consigliato

Installa CiteTrue come estensione di Claude Desktop — senza modificare JSON né configurare Node. Il server incluso gira sul Node fornito con Claude Desktop.

Scarica per Claude Desktop

Fai doppio clic sul file scaricato (o trascinalo in Impostazioni → Extensions) e incolla la tua chiave API quando richiesto — viene salvata in modo sicuro nel portachiavi del tuo sistema.

Importante: dopo l'installazione, assicurati che l'estensione sia abilitata (attiva) in Impostazioni → Extensions e riavvia Claude Desktop — è questo che attiva i suoi strumenti.

Oppure configura manualmente

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

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

Cursor

In Settings → MCP → Add new MCP server, usare la stessa struttura command / args / env del JSON Claude Desktop sotto.

Windsurf, Zed, altri

Qualsiasi client MCP stdio funziona — qualunque sia il percorso config, stessi tre campi (command, args, env).

Configurazione

Env varDefaultNote
CITETRUE_API_KEY— (Obbligatorio)Token Bearer dal dashboard.
CITETRUE_API_URLhttps://api.citetrue.comSovrascrivere per deployment self-hosted.

Strumenti

verify

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

Parametri

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

Output

{
  "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.

Fatturazione

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

Risoluzione problemi

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