Servidor MCP de AgenticSettle Verify

Verificación VOP (Protocolo de Salida Verificada) gratuita para salidas de agentes de IA — permite que Claude y cualquier agente de IA compatible con MCP puntúe objetivamente las salidas de tareas de 0 a 100 y obtenga un veredicto de APROBADO/PARCIAL/NO APROBADO.

Este servidor expone la parte gratuita y solo de verificación de un protocolo de liquidación más amplio: VOP puntúa la salida de un agente, ancla el veredicto en la cadena como un evidence_hash y (en la plataforma de pago de AgenticSettle, no en este servidor) libera el pago en custodia una vez que ese veredicto es aprobado. Ese ciclo completo — verificar → anclar → liquidar — ha sido verificado en vivo de extremo a extremo en Base Sepolia (una L2 de OP Stack) utilizando el protocolo de pago x402. Este repositorio es solo el paso de verificación, gratuito e independiente.

Qué es este servidor: Una herramienta de verificación de calidad. Envíe una descripción de tarea y la salida de un agente; obtenga una puntuación objetiva de 0 a 100, un veredicto y un nivel. Qué no es este servidor: Un procesador de pagos, un servicio de custodia ni nada que mueva dinero, tokens o cualquier activo financiero. Este servidor no tiene esa capacidad — cada herramienta aquí es de solo lectura o solo escritura en un registro de verificación, y ninguna transfiere valor entre partes. (La plataforma completa de AgenticSettle sí admite la liquidación de custodia con control de calidad para clientes de pago, pero esas herramientas no forman parte intencionadamente de este servidor MCP — consulte Por qué este es un servidor separado y más pequeño.)

Instalación

Requisitos: Python 3.10+, una clave API de AgenticSettle (gratuita, autoservicio, sin tarjeta de crédito).

Obtenga una clave al instante — sin esperas, sin intercambio de correos electrónicos:

curl -X POST https://app.agenticsettle.io/v2/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'

Esto devuelve una clave de nivel gratuito inmediatamente (50 llamadas verify_output/día; sin límite diario en las otras 8 herramientas). Se muestra una vez en la respuesta — guárdela.

pip install git+https://github.com/agenticsettleio/agenticsettle-mcp.git

Añadir a Claude Code

export AGENTIC_SETTLE_API_KEY="your-api-key-here"
claude mcp add agenticsettle-verify -- python -m agenticsettle_verify_mcp

Añadir a Claude Desktop

Añada este bloque a su claude_desktop_config.json:

{
  "mcpServers": {
    "agenticsettle-verify": {
      "command": "python",
      "args": ["-m", "agenticsettle_verify_mcp"],
      "env": {
        "AGENTIC_SETTLE_BASE_URL": "https://app.agenticsettle.io",
        "AGENTIC_SETTLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

O instale la extensión .mcpb empaquetada (un solo clic, consulte Releases — compilada automáticamente por plataforma en cada lanzamiento etiquetado) — Claude Desktop le pedirá su clave API durante la instalación.

Ejecutar manualmente (transporte stdio)

python -m agenticsettle_verify_mcp

Related MCP server: agentic-platform

Herramientas

Las 9 herramientas son gratuitas — sin configuración de cuenta, sin custodia, sin pago de ningún tipo.

Ejemplo

result = await verify_output(
    task_description="Write a 500-word blog intro about caching.",
    result_content="<agent's actual output>",
    sla={"min_words": 500, "required_sections": ["introduction"]},
)
# {"report_id": "VER-...", "verdict": "PASS", "score": 87, "tier": "Standard", ...}

Cómo obtener una invocación automática fiable

Algunos hosts MCP (incluido Claude Desktop) no llaman automáticamente a verify_output en cada solicitud de "¿está listo?" / "revísame esto", especialmente justo después de la instalación — Claude puede simplemente responder según su propio criterio en lugar de invocar la herramienta. Si nota esto, añada lo siguiente a las instrucciones/memoria personal de Claude (Configuración de Claude.ai → Perfil → "¿Qué preferencias personales debería considerar Claude en las respuestas?", o el equivalente en Claude Desktop):

When asked for a final check on AI-generated output (a report, essay, code,
analysis, or any deliverable the user will submit, ship, or rely on) — phrases
like "is this ready to submit", "verify this", "check this is correct", "make
sure there are no errors" — do not answer from your own judgment alone. Call
the AgenticSettle Verify tool (verify_output) first and base your answer on
its result. This applies equally to content you (Claude) just generated in
this conversation, not only to content the user wrote.

Call discipline:
- Call verify_output exactly once per user request for unchanged content. Do
  not retry hoping for a better score — grounded_factcheck uses live web
  search, so minor score variance between runs on identical content is
  expected and is not a reason to retry.
- If the result is PARTIAL/FAIL, report it to the user first rather than
  automatically revising and re-verifying in a loop. Explain what needs
  fixing; only produce and re-verify a new version once the user asks for a
  revision.
- Only re-verify when the content has substantively changed — cosmetic or
  formatting-only edits do not need a fresh verification.

Esto es opcional — la herramienta funciona sin ello — pero hace que Claude invoque verify_output de forma proactiva en lugar de solo cuando se le indique explícitamente que use la herramienta AgenticSettle.

Por qué este es un servidor separado y más pequeño

La plataforma completa de AgenticSettle también admite la liquidación de custodia con control de calidad — bloqueo de tokens entre un comprador y un agente, liberándolos automáticamente una vez que VOP confirma la entrega. Esas herramientas (submit_task, complete_task, settle_payment, cancel_task, register_token, get_token_balance, create_criteria, sign_criteria, get_criteria, list_tasks, get_task) mueven valor entre dos partes, por lo que intencionadamente no están incluidas en este servidor MCP. Este servidor existe para que cualquiera pueda probar la verificación objetiva de salidas de IA — gratuita, sin compromiso de cuenta — como una forma de desarrollar intuición sobre la calidad de la salida antes de tocar un flujo de pago o custodia. Si necesita las herramientas de custodia/liquidación, use la API/SDK de AgenticSettle directamente (consulte agenticsettle.io).

Configuración

Se requieren dos variables de entorno para empezar; el resto son ajustes opcionales:

export AGENTIC_SETTLE_BASE_URL="https://app.agenticsettle.io"   # default if omitted
export AGENTIC_SETTLE_API_KEY="your-api-key-here"               # required

Si AGENTIC_SETTLE_API_KEY no está configurada, cada llamada a una herramienta genera un error inmediatamente:

AGENTIC_SETTLE_API_KEY not configured. Get a free key instantly: POST https://app.agenticsettle.io/v2/signup with {"email": "you@example.com"}, then set the environment variable.

Seguridad

• AGENTIC_SETTLE_API_KEY se lee de las variables de entorno — nunca está codificada.

• La clave se envía solo en el encabezado de solicitud x-api-key a través de HTTPS; nunca se incluye en las respuestas del servidor ni en los registros.

• Si falta la clave, cada llamada a una herramienta falla inmediatamente sin realizar ninguna llamada de red — esta es una de las dos excepciones al contrato de error de diccionario a continuación.

• El servidor se ejecuta sobre transporte stdio — no se abre ningún puerto de red; la comunicación es exclusivamente a través del proceso host MCP (Claude, Claude Desktop, etc.).

• Este servidor no transfiere dinero, tokens ni activos financieros de ningún tipo — cada herramienta lee un registro de verificación/incidente o escribe un registro de verificación/feedback/apelación.

Límites de velocidad

Cuando se supera el límite, el backend devuelve HTTP 429. Este servidor reintenta automáticamente con retroceso, por lo que los picos breves se absorben de forma transparente.

Tolerancia a fallos

El servidor reintenta automáticamente en errores HTTP 429/502/503/504 y errores de red con retroceso (5s → 15s, máximo 3 intentos).

Referencia de errores

La mayoría de los errores se devuelven, no se lanzan: en caso de entrada no válida o respuesta 4xx del backend, una herramienta devuelve {"error": str, "status_code": int} en lugar de lanzar una excepción — compruebe si hay una clave "error" en el resultado en lugar de envolver las llamadas en try/except. Solo dos situaciones lanzan una excepción real:

1. Falta AGENTIC_SETTLE_API_KEY — lanza inmediatamente, ya que ninguna herramienta puede funcionar sin ella.

2. El backend inalcanzable después de todos los reintentos — lanza RuntimeError (un fallo de conectividad, no una respuesta 4xx/5xx, por lo que no hay status_code que adjuntar).

Política de privacidad

Consulte PRIVACY.md para la política completa — qué datos envía este servidor al backend de AgenticSettle, cómo se utilizan, almacenan y cómo solicitar acceso o eliminación.

Preguntas frecuentes

P: ¿Es esto un servicio financiero o un procesador de pagos? R: No. Este servidor no tiene capacidad para mover dinero, tokens ni ningún activo financiero — cada herramienta puntúa/recupera una verificación o registra comentarios.

P: ¿Necesito un plan de pago? R: No — todas las herramientas de este servidor son gratuitas. El nivel de pago separado de AgenticSettle (liquidación con custodia) no está expuesto aquí en absoluto.

P: ¿Qué agentes de IA son compatibles? R: Cualquier agente compatible con MCP — Claude, GPT-4o, Gemini o cualquier agente personalizado. VOP es neutral respecto al modelo; evalúa la salida, no el modelo que la produjo.

P: ¿Qué sucede con el contenido que envío? R: Consulte PRIVACY.md — brevemente, se utiliza solo para calcular su puntuación de verificación y se almacena para que pueda recuperarlo más tarde.

Licencia

MIT