Perf MCP
Verificación de hechos y corrección de salidas de IA: detección de alucinaciones, validación de esquemas y reparación automática.
Documentación
perf-mcp
Verifica y corrige salidas de IA. Detecta alucinaciones, repara JSON roto, corrige errores — antes de que lleguen a los usuarios.
Funciona con Claude Code, Cursor, Windsurf, Cline y cualquier cliente compatible con MCP.
Inicio Rápido
Añade a la configuración de tu cliente MCP:
{
"mcpServers": {
"perf": {
"command": "npx",
"args": ["-y", "perf-mcp"],
"env": {
"PERF_API_KEY": "pk_live_xxx"
}
}
}
}
Obtén tu clave API en dashboard.withperf.pro — 200 verificaciones gratuitas, sin tarjeta de crédito.
Herramientas
perf_verify
Detecta y repara alucinaciones en texto generado por LLM. Utiliza verificación multicanal (búsqueda web, modelos NLI, referencias cruzadas) — no es solo otra verificación 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 generado por LLM contra un esquema y repara automáticamente las violaciones. Corrige enums malformados, tipos incorrectos, campos faltantes, propiedades 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
Corrección de salida de propósito general. Clasifica el tipo de error y aplica la corrección adecuada — alucinación, violación de esquema, inconsistencia semántica o desviación de instrucciones.
perf_correct({ content: "The Great Wall was built in 1950.", correction_budget: "fast" })
→ Corrected: temporal_error + factual_error detected (87% confidence)
perf_chat
Enruta solicitudes de LLM al modelo óptimo automáticamente. Selecciona entre GPT-4o, Claude, Gemini y más de 20 modelos según la complejidad de la tarea. Formato compatible con OpenAI.
Configuración por Cliente
Claude Code
Añade al .mcp.json de tu proyecto:
{
"mcpServers": {
"perf": {
"command": "npx",
"args": ["-y", "perf-mcp"],
"env": {
"PERF_API_KEY": "pk_live_xxx"
}
}
}
}
Cursor
Configuración → MCP → Añadir Servidor:
{
"mcpServers": {
"perf": {
"command": "npx",
"args": ["-y", "perf-mcp"],
"env": {
"PERF_API_KEY": "pk_live_xxx"
}
}
}
}
Windsurf
Añade a ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"perf": {
"command": "npx",
"args": ["-y", "perf-mcp"],
"env": {
"PERF_API_KEY": "pk_live_xxx"
}
}
}
}
Variables de Entorno
| Variable | Requerida | Descripción |
|---|---|---|
PERF_API_KEY | Sí | Tu clave API de Perf (pk_live_xxx) |
PERF_BASE_URL | No | Sobrescribir URL de API (para pruebas) |
Precios
| Plan | Créditos | Precio |
|---|---|---|
| Gratis | 200 verificaciones | $0 (nunca expira) |
| Pro | 1,000/mes | $19/mes |
| Pago por uso | Ilimitado | $0.02/verificación |
1 llamada de herramienta = 1 crédito. Comienza en dashboard.withperf.pro.
Licencia
MIT