AgentBase MCP Server

Instructions

Implementation Reference

• index.js:230-244 (handler)

  The main handler function that fetches the registry index, filters for featured entries (quality score 90+), formats them as a readable list, and returns the result as MCP content.

  async function handleGetFeatured() {
    const index = await fetchIndex();
    const featured = (index.entries || []).filter(e => e.featured);
  
    const output = featured.map(e =>
      `**${e.title}** [${e.category}]\nslug: ${e.slug} | quality: ${e.quality_score}/100\ntags: ${(e.tags || []).join(', ')}`
    );
  
    return {
      content: [{
        type: 'text',
        text: `Featured files (${featured.length} total — quality score 90+):\n\n${output.join('\n\n')}\n\nUse get_instruction with any slug to fetch the full file.`
      }]
    };
  }

• index.js:109-116 (schema)

  Tool schema definition specifying the tool name, description, and empty input parameters (no arguments required).

  {
    name: 'get_featured',
    description: 'Return all featured instruction files (quality score 90+). These are verified, complete, and production-tested. Good starting point for finding high-quality instructions.',
    inputSchema: {
      type: 'object',
      properties: {}
    }
  }

• index.js:263-263 (registration)

  Router registration in the CallToolRequestSchema handler that maps 'get_featured' tool calls to the handleGetFeatured function.

  case 'get_featured': return await handleGetFeatured();

• index.js:29-33 (helper)

  Helper function that fetches and parses the registry index JSON from the remote URL, used by handleGetFeatured to retrieve the data.

  async function fetchIndex() {
    const res = await fetch(INDEX_URL);
    if (!res.ok) throw new Error(`Registry unavailable: ${res.status}`);
    return res.json();
  }