skvil-mcp

Instructions

Implementation Reference

• src/tools.ts:196-243 (handler)

  The skvil_catalog tool registration and handler - defines the tool metadata, empty schema, and the async handler that calls api.catalog() and formats the results for display with skill details including name, level, reputation score, author, version, description, provider, agent, file count, certification date, install URL, and composite hash.

  // ── skvil_catalog ──────────────────────────────────────────────────────────
  server.tool(
    'skvil_catalog',
    'Browse the full catalog of Skvil-certified AI agent skills with detailed ' +
      'metadata: author, version, description, provider, agent platform, file ' +
      'count, and install URL. Returns up to 100 skills. Use this to discover ' +
      'safe skills available for installation.',
    {},
    async () => {
      try {
        const result = await api.catalog();
  
        if (result.length === 0) {
          return {
            content: [
              {
                type: 'text',
                text: 'The skill catalog is empty. No certified skills available yet.',
              },
            ],
          };
        }
  
        const lines = [`**Skvil skill catalog** (${result.length} certified skills)\n`];
  
        for (const skill of result) {
          const parts = [`- **${skill.name}**`];
          parts.push(`  Level: ${skill.level} | Score: ${formatScore(skill.reputation_score)} | ${skill.total_scans} scans`);
          if (skill.author) parts.push(`  Author: ${skill.author}`);
          if (skill.version) parts.push(`  Version: ${skill.version}`);
          if (skill.description) parts.push(`  ${skill.description}`);
          if (skill.provider) parts.push(`  Provider: ${skill.provider}`);
          if (skill.agent) parts.push(`  Agent: ${skill.agent}`);
          parts.push(`  Files: ${skill.file_count} | Certified: ${skill.certified_at}`);
          if (skill.skill_url) parts.push(`  Install: ${skill.skill_url}`);
          parts.push(`  Hash: \`${skill.composite_hash}\``);
          lines.push(parts.join('\n'));
        }
  
        return { content: [{ type: 'text', text: lines.join('\n\n') }] };
      } catch (error) {
        return {
          content: [{ type: 'text', text: formatError('catalog', error) }],
          isError: true,
        };
      }
    },
  );

• src/tools.ts:197-204 (registration)

  Tool registration call - registers 'skvil_catalog' with MCP server using server.tool(), providing name, description, empty schema object, and handler function.

  server.tool(
    'skvil_catalog',
    'Browse the full catalog of Skvil-certified AI agent skills with detailed ' +
      'metadata: author, version, description, provider, agent platform, file ' +
      'count, and install URL. Returns up to 100 skills. Use this to discover ' +
      'safe skills available for installation.',
    {},
    async () => {

• src/api.ts:140-142 (helper)

  API function that implements the catalog endpoint - makes a GET request to '/catalog' and returns array of CatalogSkill objects with full metadata.

  export async function catalog(): Promise<CatalogSkill[]> {
    return request<CatalogSkill[]>('GET', '/catalog');
  }

• src/types.ts:57-71 (schema)

  Type definition for CatalogSkill - defines the structure of catalog data including name, composite_hash, level, reputation_score, certified_at, total_scans, skill_url, provider, agent, file_count, author, version, and description fields.

  export interface CatalogSkill {
    name: string;
    composite_hash: string;
    level: 'V1' | 'V2' | 'V3' | 'Gold';
    reputation_score: number;
    certified_at: string;
    total_scans: number;
    skill_url?: string | null;
    provider?: string | null;
    agent?: string | null;
    file_count: number;
    author?: string | null;
    version?: string | null;
    description?: string | null;
  }