Perf MCP
Verificação de fatos e correção de saídas de IA — detecção de alucinações, validação de esquemas e reparo automático.
Documentação
perf-mcp
Verifique e corrija saídas de IA. Detecta alucinações, repara JSON quebrado, corrige erros — antes que cheguem aos usuários.
Funciona com Claude Code, Cursor, Windsurf, Cline e qualquer cliente compatível com MCP.
Início Rápido
Adicione à configuração do seu cliente MCP:
{
"mcpServers": {
"perf": {
"command": "npx",
"args": ["-y", "perf-mcp"],
"env": {
"PERF_API_KEY": "pk_live_xxx"
}
}
}
}
Obtenha sua chave de API em dashboard.withperf.pro — 200 verificações gratuitas, sem cartão de crédito.
Ferramentas
perf_verify
Detecta e repara alucinações em texto gerado por LLM. Usa verificação multicanal (busca na web, modelos NLI, referência cruzada) — não é apenas mais uma verificação de LLM.
perf_verify({ content: "The Eiffel Tower was built in 1887." })
→ Corrected: "built in 1887" → "inaugurated in 1889" (89% confidence)
perf_validate
Valida JSON gerado por LLM contra um esquema e repara violações automaticamente. Corrige enums malformados, tipos errados, campos ausentes, propriedades alucinadas.
perf_validate({
content: '{"name": "John", "age": "twenty"}',
target_schema: { type: "object", properties: { name: { type: "string" }, age: { type: "number" } } }
})
→ Rejected: /age must be number
perf_correct
Correção de saída de propósito geral. Classifica o tipo de erro e aplica a correção adequada — alucinação, violação de esquema, inconsistência semântica ou desvio de instrução.
perf_correct({ content: "The Great Wall was built in 1950.", correction_budget: "fast" })
→ Corrected: temporal_error + factual_error detected (87% confidence)
perf_chat
Roteia solicitações de LLM para o modelo ideal automaticamente. Seleciona entre GPT-4o, Claude, Gemini e mais de 20 modelos com base na complexidade da tarefa. Formato compatível com OpenAI.
Configuração por Cliente
Claude Code
Adicione ao .mcp.json do seu projeto:
{
"mcpServers": {
"perf": {
"command": "npx",
"args": ["-y", "perf-mcp"],
"env": {
"PERF_API_KEY": "pk_live_xxx"
}
}
}
}
Cursor
Configurações → MCP → Adicionar Servidor:
{
"mcpServers": {
"perf": {
"command": "npx",
"args": ["-y", "perf-mcp"],
"env": {
"PERF_API_KEY": "pk_live_xxx"
}
}
}
}
Windsurf
Adicione ao ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"perf": {
"command": "npx",
"args": ["-y", "perf-mcp"],
"env": {
"PERF_API_KEY": "pk_live_xxx"
}
}
}
}
Variáveis de Ambiente
| Variável | Obrigatório | Descrição |
|---|---|---|
PERF_API_KEY | Sim | Sua chave de API Perf (pk_live_xxx) |
PERF_BASE_URL | Não | Substituir URL da API (para testes) |
Preços
| Plano | Créditos | Preço |
|---|---|---|
| Grátis | 200 verificações | $0 (nunca expira) |
| Pro | 1.000/mês | $19/mês |
| Pague conforme o uso | Ilimitado | $0,02/verificação |
1 chamada de ferramenta = 1 crédito. Comece em dashboard.withperf.pro.
Licença
MIT