skvil-mcp

Instructions

Implementation Reference

• src/tools.ts:148-194 (registration)

  Tool registration and handler implementation for 'skvil_certified'. Registers the tool with the MCP server, defines its description, and implements the async handler that calls api.certified() and formats the response with skill names, certification levels, reputation scores, scan counts, and certification dates.

  // ── skvil_certified ───────────────────────────────────────────────────────
  server.tool(
    'skvil_certified',
    'List skills that have been verified and certified by Skvil admins. ' +
      'Certified skills have been manually reviewed and registered for ' +
      'tamper-proof verification. Returns up to 10 most recently certified ' +
      'skills with their level (V1/V2/V3/Gold), reputation score, and ' +
      'certification date.',
    {},
    async () => {
      try {
        const result = await api.certified();
  
        if (result.length === 0) {
          return {
            content: [
              {
                type: 'text',
                text: 'No skills are currently certified. Be the first to get certified!',
              },
            ],
          };
        }
  
        const lines = ['**Certified skills**\n'];
  
        for (const skill of result) {
          lines.push(
            `- **${skill.name}** — ${skill.level} | Score: ${formatScore(skill.reputation_score)} | ` +
              `${skill.total_scans} scans | Certified: ${skill.certified_at}\n` +
              `  Hash: \`${skill.composite_hash}\``,
          );
        }
  
        lines.push(
          '\nAll certifications are registered for tamper-proof, publicly verifiable trust.',
        );
  
        return { content: [{ type: 'text', text: lines.join('\n') }] };
      } catch (error) {
        return {
          content: [{ type: 'text', text: formatError('certified', error) }],
          isError: true,
        };
      }
    },
  );

• src/api.ts:134-137 (helper)

  API helper function that makes the HTTP GET request to the '/certified' endpoint to retrieve the list of certified skills from the Skvil server.

  /** List actively certified skills. */
  export async function certified(): Promise<CertifiedSkill[]> {
    return request<CertifiedSkill[]>('GET', '/certified');
  }

• src/types.ts:48-55 (schema)

  Type definition for the CertifiedSkill interface that defines the structure of the response data, including name, composite_hash, certification level (V1/V2/V3/Gold), reputation_score, certified_at timestamp, and total_scans.

  export interface CertifiedSkill {
    name: string;
    composite_hash: string;
    level: 'V1' | 'V2' | 'V3' | 'Gold';
    reputation_score: number;
    certified_at: string;
    total_scans: number;
  }

• src/tools.ts:13-17 (helper)

  Helper function formatScore used by the skvil_certified handler to format reputation scores with safety indicators (safe, caution, danger).

  function formatScore(score: number): string {
    if (score >= 80) return `${score.toFixed(1)} (safe)`;
    if (score >= 50) return `${score.toFixed(1)} (caution)`;
    return `${score.toFixed(1)} (danger)`;
  }