Freesound MCP Server

Instructions

Implementation Reference

• src/index.ts:311-321 (handler)

  Handler logic for the 'get_pack' tool: calls FreesoundClient.getPack with pack_id argument and returns the pack data as JSON text.

  case "get_pack": {
    const pack = await freesoundClient.getPack(args.pack_id as number);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(pack, null, 2),
        },
      ],
    };
  }

• src/index.ts:168-181 (registration)

  Registration of the 'get_pack' tool in the ListTools response, including name, description, and input schema requiring 'pack_id'.

  {
    name: "get_pack",
    description: "Get information about a sound pack",
    inputSchema: {
      type: "object",
      properties: {
        pack_id: {
          type: "number",
          description: "The ID of the pack",
        },
      },
      required: ["pack_id"],
    },
  },

• src/freesound-client.ts:226-229 (helper)

  Core implementation of getPack in FreesoundClient: makes API GET request to /packs/{packId}/ and returns the Pack data.

  async getPack(packId: number): Promise<Pack> {
    const response = await this.axiosInstance.get(`/packs/${packId}/`);
    return response.data;
  }

• src/freesound-client.ts:85-95 (schema)

  TypeScript interface defining the structure of a Pack object returned by getPack.

  export interface Pack {
    id: number;
    url: string;
    description: string;
    created: string;
    name: string;
    username: string;
    num_sounds: number;
    sounds: string;
    num_downloads: number;
  }