Philidor MCP Server

Instructions

Implementation Reference

• src/tools/get-curator-info.ts:6-18 (handler)

  Main handler implementation for get_curator_info tool. Registers the tool with input schema (curatorId) and executes the async handler that fetches curator data via API and formats the response.

  export function registerGetCuratorInfo(server: McpServer) {
    server.tool(
      'get_curator_info',
      'Get detailed information about a vault curator including their managed vaults, TVL, chain distribution, and performance.',
      {
        curatorId: z.string().describe('Curator ID'),
      },
      async (params) => {
        const result = await apiGet<{ data: any }>(`/v1/curators/${params.curatorId}`);
        const text = formatCuratorInfo(result.data);
        return { content: [{ type: 'text' as const, text }] };
      }
    );

• src/tools/get-curator-info.ts:10-12 (schema)

  Input schema definition using zod. Validates that curatorId is a required string parameter.

  {
    curatorId: z.string().describe('Curator ID'),
  },

• src/server.ts:37-37 (registration)

  Registration of get_curator_info tool in the server initialization. Calls registerGetCuratorInfo to register the tool with the MCP server.

  registerGetCuratorInfo(server);

• src/lib/formatters.ts:145-170 (helper)

  formatCuratorInfo helper function that formats the raw API response data into a human-readable markdown string with curator name, TVL, vault count, APR, chain distribution, and top vaults.

  export function formatCuratorInfo(data: any): string {
    const { curator, vaults, chainDistribution } = data;
    const sections = [
      `## ${curator.name}`,
      curator.one_liner ? `\n${curator.one_liner}` : '',
      `\n**TVL:** $${formatNumber(curator.tvl_total)} | **Vaults:** ${curator.vault_count} | **Avg APR:** ${formatPercent(curator.avg_apr)}`,
    ].filter(Boolean);
  
    if (chainDistribution?.length) {
      sections.push('\n### Chain Distribution');
      for (const c of chainDistribution) {
        sections.push(`- **${c.name}**: ${c.vault_count} vaults, $${formatNumber(c.tvl)} TVL`);
      }
    }
  
    if (vaults?.length) {
      sections.push(`\n### Top Vaults (${Math.min(vaults.length, 5)} of ${vaults.length})`);
      for (const v of vaults.slice(0, 5)) {
        sections.push(
          `- **${v.name}** (${v.chain_name || 'Unknown'}): $${formatNumber(v.tvl_usd)} TVL, ${formatPercent(v.apr_net)} APR, Score ${v.total_score ?? v.risk_score ?? 'N/A'}/10`
        );
      }
    }
  
    return sections.join('\n');
  }

• src/api-client.ts:3-19 (helper)

  apiGet helper function that makes HTTP GET requests to the Philidor API with proper error handling and JSON response parsing.

  export async function apiGet<T = any>(path: string): Promise<T> {
    const res = await fetch(`${API_BASE}${path}`, {
      headers: { Accept: 'application/json' },
    });
    if (!res.ok) {
      let message: string;
      try {
        const json = (await res.json()) as Record<string, any>;
        message = json?.error?.message || json?.message || JSON.stringify(json);
      } catch {
        message = res.statusText || `HTTP ${res.status}`;
      }
      throw new Error(`API ${res.status}: ${message}`);
    }
    const json = await res.json();
    return json as T;
  }