MCP Server

Adiciona verificação de citações acadêmicas ao Claude Desktop, Cursor ou qualquer cliente MCP.

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

O que você obtém

Duas ferramentas que encapsulam a API REST CiteTrue. Mesmos créditos, mesma precisão — só via MCP em vez de HTTP.

Ferramenta	Finalidade	Créditos / chamada
verify	Split a text blob into references and verify each against real sources.	1 per ref; tricky ones up to 5
get_credits	Retorna o saldo de créditos da conta.	0

Início rápido

Ir a Painel → Chaves API e clicar em Nova chave API. Copiar a chave que começa com sk_.
Abrir a config do cliente MCP (ver Configuração do cliente) e adicionar o bloco citetrue.
Reiniciar o cliente MCP — não apenas o chat, o app inteiro.
Pedir ao assistente "Verifique estas citações: [colar]". Ele chamará verify e resumirá.

Configuração do cliente

Qualquer cliente MCP stdio funciona. Abaixo os três mais comuns; outros usam a mesma estrutura.

Claude Desktop

Recomendado

Instale o CiteTrue como extensão do Claude Desktop — sem editar JSON nem configurar Node. O servidor empacotado roda no Node que vem com o Claude Desktop.

Baixar para o Claude Desktop

Dê dois cliques no arquivo baixado (ou arraste-o para Configurações → Extensions) e cole sua chave de API quando solicitado — ela é armazenada com segurança no chaveiro do seu sistema.

Importante: após instalar, confirme que a extensão está ativada (ligada) em Configurações → Extensions e reinicie o Claude Desktop — é isso que ativa as ferramentas dela.

Ou configurar manualmente

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

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

Cursor

Em Settings → MCP → Add new MCP server, usar a mesma estrutura command / args / env que o JSON do Claude Desktop abaixo.

Windsurf, Zed, outros

Qualquer cliente MCP stdio funciona — qualquer que seja o caminho da config, os mesmos três campos (command, args, env).

Configuração

Variável env	Padrão	Notas
CITETRUE_API_KEY	— (Obrigatório)	Token Bearer do dashboard.
CITETRUE_API_URL	`https://api.citetrue.com`	Sobrescrever para deploys self-hosted.

Ferramentas

verify

Split a free-form text blob into individual references and verify each against real sources. Every reference goes through the same flow, and each one in the result reports what it cost.

Parâmetros

Supply exactly one of text or taskHash:

text string — raw text containing one or more references: numbered / bulleted / blank-line-separated lists, BibTeX, or prose with in-text author-year citations. Max 10MB.
taskHash string — resume a task started by an earlier call (the taskHash it returned). Finished results are replayed without charging again; citations that still need checking are completed and billed as usual.
force bool, optional — ignore cached results and check the text again from scratch (billed like a new check). Only applies with text.

Saída

{
  "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": [],
      "confidence": 0.97,
      "cost": 1
    }
  ],
  "cost": 2,
  "balance": 248
}

Each ref's cost is what the task has charged for that citation: 1 for most citations, up to 5 for tricky ones that needed more data sources and more analysis, 0 if it was already paid for in another task. Resuming a task with taskHash reports the same per-ref numbers again — they are not new charges. The top-level cost is what this call newly charged (0 when a finished task is simply replayed), and balance is what's left afterwards — it can be negative (see Billing). 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; errors[] lists tokens.
exceeded — credits ran out before this ref ran.

Faturamento

Same credits as the REST API. Most citations cost 1 credit. Tricky ones that need more data sources and more analysis can cost up to 5. If you run out of credits mid-check, citations already in progress still finish; the overage is deducted at your next credit reset, so balance can be negative. Citations that couldn't start for lack of credits come back as exceeded. get_credits is free.

Solução de problemas

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

Mantido pela equipa CiteTrue · Última atualização: 1 de outubro de 2026