agentgrade

← Knowledge Base

Cómo funciona la puntuación

agentgrade verifica 10 capacidades en pagos, descubrimiento e identidad. Cada capacidad tiene sub-verificaciones que se dividen en dos niveles:

• Verificada — agentgrade realizó una solicitud en vivo y confirmó que la capacidad funciona (por ejemplo, el handshake MCP se completó, la especificación OpenAPI devolvió JSON válido)
• Declarada — se encontró un manifiesto o archivo de configuración que afirma que la capacidad existe, pero no se confirmó de forma independiente

Las verificaciones confirmadas tienen un peso 2x en el cálculo de la puntuación. Un sitio que funciona vale más que un sitio que afirma funcionar.

Las 10 capacidades

Pagos (mayor peso)

• Machine Payments — x402, MPP o L402 detectado mediante encabezados HTTP 402
• Bazaar — Catálogo de servicios x402.json con endpoints descubribles

Descubrimiento

• MCP — Endpoint Model Context Protocol (JSON-RPC 2.0)
• AI Plugin — Manifiesto ai-plugin.json con especificación de API accesible
• Claude Plugin — Manifiesto claude.json con endpoints válidos
• OpenAPI — Especificación openapi.json que devuelve JSON válido
• llms.txt — Archivo de contexto LLM que comienza con un encabezado H1
• Skills — Manifiesto skills.json con endpoints accesibles

Informativas (menor peso)

• agents.txt — Archivo de política de acceso para agentes
• robots.txt — Directivas para rastreadores de IA

Opcionales (no afectan negativamente tu puntuación)

• Identity — WebFinger, DID, Nostr NIP-05, AT Protocol DID

Desglose de la puntuación

La puntuación porcentual es: (peso de verificaciones aprobadas / peso total de verificaciones) × 100

El resumen muestra "X / Y checks passed" donde Y excluye las verificaciones opcionales que no se encontraron. Las verificaciones opcionales (protocolos de identidad) solo pueden mejorar tu puntuación, nunca perjudicarla.

Cómo mejorar tu puntuación

Agrega archivos de descubrimiento primero — /openapi.json y /llms.txt son las victorias más fáciles

Asegúrate de que funcionen — una especificación OpenAPI accesible y válida te otorga verificaciones confirmadas, no solo declaradas

Agrega MCP — el handshake MCP (initialize → tools/list → tools/call) otorga múltiples verificaciones confirmadas

Agrega soporte de pagos — encabezados x402 o MPP en al menos un endpoint activa la capacidad de Machine Payments

Publica un catálogo de servicios — /.well-known/x402.json con endpoints descubribles otorga verificaciones de Bazaar